- Home
- /
- Categories
- /
- Comments
Comments
Code comments and annotations
wide-events
by front-depiction
Conceptual guide to wide events (canonical log lines) for observability. Use when thinking about instrumentation strategy, span annotations, or designing what context to capture.
mongodb-query-and-index-optimize
by romiluz13
MongoDB query optimization and indexing strategies. Use when writing queries, creating indexes, building aggregation pipelines, or debugging slow operations. Triggers on "slow query", "create index", "optimize query", "aggregation pipeline", "explain output", "COLLSCAN", "ESR rule", "compound index", "partial index", "TTL index", "text search", "geospatial", "$indexStats", "profiler".
jskim
by garvit-joshi
Token-saving Java file reader. Use when working with Java files (.java) to reduce token usage. Auto-triggers when exploring, reading, or understanding Java classes, services, controllers, entities, or any .java files. Run jskim before using the Read tool on Java files to understand structure first, then Read only the lines you need.
bid-software-design
by youyouhe
基于需求规格编写软件概要设计和详细设计文档。从需求元数据和各系统需求规格中读取业务对象、 接口、用例等信息,生成数据库设计、API设计、模块设计等工程级设计文档。 采用三阶段架构:Phase 0 生成设计元数据,Phase 1 按系统生成概要设计,Phase 2 按子模块生成详细设计。 核心特性:大文档自动拆分,按系统规模分级处理(小/中/大),避免单次输出过大。 当用户要求编写软件设计、概要设计、详细设计、数据库设计、API设计时触发。 也支持修复模式:当用户要求修复/补充设计文档时触发。 前置条件:需已完成 bid-requirements 生成需求规格文件。
postgresql
by jgamaraalv
"PostgreSQL 16+ reference for writing queries, designing schemas, managing indexes, and optimizing performance. Use when: (1) writing SQL queries (SELECT, INSERT, UPDATE, DELETE, CTEs, window functions, subqueries), (2) designing or altering table schemas (CREATE TABLE, constraints, sequences, data types), (3) choosing or creating indexes (B-tree, GIN, GiST, BRIN, partial, expression), (4) managing transactions and isolation levels (BEGIN/COMMIT, savepoints, MVCC), (5) working with JSONB data and jsonpath, (6) analyzing query performance with EXPLAIN ANALYZE, or (7) using the psql CLI."
articulation
by kluless13
Framework for articulating ideas intelligently in writing and speaking. Based on Dan Koe's methods. TRIGGERS: - When user asks to write a post, thread, or newsletter - When user is preparing for a podcast or presentation - When user wants to explain a complex idea - When user says "help me articulate" or "how do I explain" - When drafting content that needs to be compelling and clear CAPABILITIES: - Structure ideas using Problem-Amplify-Solution (beginner) - Apply Pyramid Principle for logical arguments (intermediate) - Cross-domain synthesis for unique perspectives (advanced) - Build "greatest hits" library of core ideas
trace-annotation-tool
by maragudk
Generate a custom trace annotation web app for open coding during LLM error analysis. Use when the user wants to review LLM traces, annotate failures with freeform comments, and do first-pass qualitative labeling (open coding). Also use when the user mentions "annotate traces", "trace review tool", "open coding tool", "label traces", "build an annotation interface", "review LLM outputs", or wants to manually inspect pipeline traces before building a failure taxonomy. This skill produces a tailored Python web application using FastHTML, TailwindCSS, and HTMX.
anndata
by ovachiever
This skill should be used when working with annotated data matrices in Python, particularly for single-cell genomics analysis, managing experimental measurements with metadata, or handling large-scale biological datasets. Use when tasks involve AnnData objects, h5ad files, single-cell RNA-seq data, or integration with scanpy/scverse tools.
clinvar-database
by ovachiever
"Query NCBI ClinVar for variant clinical significance. Search by gene/position, interpret pathogenicity classifications, access via E-utilities API or FTP, annotate VCFs, for genomic medicine."
deep-plan
by theclaymethod
Structured research → plan → annotate → implement workflow for non-trivial features. Separates planning from execution using persistent markdown artifacts (.claude/research.md, .claude/plan.md). Use when explicitly invoked via /deep-plan for feature development, refactors, migrations, or any multi-file change where architecture decisions matter.
Commenting Intent
by obra
Comment WHY code exists and non-obvious decisions, not WHAT code does (mechanics)
Designing Before Coding
by obra
Design in pseudocode first, iterate approaches, then translate to code
Writing Evergreen Comments
by obra
Write comments explaining WHAT and WHY, never temporal context or history
data-visualizer
by oakoss
'Charts, dashboards, and data visualizations using Recharts, Chart.js, and D3.js. Use when building charts, dashboards, or interactive data displays. Use for chart type selection, data storytelling, annotation patterns, responsive design, accessibility, and performance optimization.'
issue-lifecycle
by troykelly
Use throughout all work - ensures GitHub issues are updated continuously as work happens, not batched at the end
cortex-classify-tutorial
by Snowflake-Labs
Interactive tutorial teaching Snowflake Cortex CLASSIFY_TEXT for categorizing unstructured text. Guide users through classifying customer reviews using Python and SQL. Use when user wants to learn text classification, Cortex LLM functions, or analyze unstructured feedback data.
tpm-spec-trace-ids
by ozten
Annotate a Spec/PRD with Feature IDs and generate a Coverage Index. Use when user wants to add spec tags to a vision document, create F-nnn identifiers, set up traceability, or initialize a PRD framework for phased development.
wfc-deepen
by sam-fakhreddine
Augments an existing /wfc-plan directory by researching codebase patterns, project documentation, and dependency constraints to add supporting evidence to tasks. Reads TASKS.md and PROPERTIES.md, simulates parallel analysis across 4 dimensions, and appends sourced findings as annotations. Does NOT modify task structure, add/remove tasks, or write implementation steps. Triggers: /wfc-deepen, /wfc-deepen <path>, "add research evidence to the plan", "validate plan against codebase patterns", "annotate plan with known pitfalls", "cross-reference plan with existing solutions". Not for: writing or expanding task implementation steps; decomposing tasks into subtasks; prioritizing or reordering tasks; adding or removing tasks; pre-planning research before a plan directory exists; targeted research on specific questions unrelated to plan validation; re-deepening plans with existing Research Findings sections (use --force to override); general research with no plan context.
tpm-roadmap-slice
by ozten
Generate a Phase Spec/PRD by extracting features from an annotated Vision PRD. Use when user wants to create quarterly phase documentation, extract requirements from vision, plan a development phase, or decompose features into R-nnnn requirements. Requires annotated Vision PRD with F-nnn tags and Coverage Index.
comment-generator
by Dexploarer
Generate code comments and docstrings. Use when user asks to "add comments", "document this code", "explain with comments", or "add docstrings".
a11y-annotation-generator
by Dexploarer
Adds accessibility annotations (ARIA labels, roles, alt text) to make web content accessible. Use when user asks to "add accessibility", "make accessible", "add aria labels", "wcag compliance", or "screen reader support".
code-patterns
by xu-cell
后端代码禁令和编码规范速查。本项目是纯后端项目,前端代码在分离的项目中开发。 触发场景: - 查看项目禁止事项(后端代码) - 命名规范速查 - Git 提交规范 - 代码风格检查 - 避免过度工程 触发词:规范、禁止、命名、Git提交、代码风格、不能用、不允许、包名、架构 注意:后端 CRUD 开发规范请激活 crud-development,API 开发规范请激活 api-development,数据库设计规范请激活 database-ops。
by samhvw8
"PDF document processing and manipulation. Tools: Python (PyPDF2, pdfplumber, reportlab), CLI tools. Capabilities: text extraction, table extraction, form filling, merge/split documents, create PDFs, add annotations, watermarks, page manipulation. Actions: extract, create, merge, split, fill, annotate PDFs. Keywords: PDF, text extraction, table extraction, form fill, PDF form, merge PDF, split PDF, create PDF, reportlab, PyPDF2, pdfplumber, annotation, watermark, page rotation, PDF metadata, bookmarks, OCR. Use when: extracting text/tables from PDFs, filling PDF forms, merging/splitting documents, creating PDFs programmatically, adding annotations/watermarks, processing PDFs at scale."
screengrabs
by inkeep
"Capture, annotate, and include screenshots in pull requests for UI changes. Use when creating or updating PRs that touch frontend components, pages, or any web-facing surface. Also use when asked to add before/after screenshots, visual diffs, or enrich PR descriptions. Triggers on: PR screenshots, before/after, visual diff, PR description, capture screenshot, PR images, enrich PR."