write-a-skill
Writing Skills
Process
-
Gather requirements — 询问用户：
- skill 覆盖什么 task/domain？
- 应处理哪些具体 use cases？
- 需要 executable scripts，还是只需要 instructions？
- 是否有 reference materials 要包含？
-
Draft the skill — 创建：
- 带 concise instructions 的 SKILL.md
- 如果内容超过 500 行，创建 additional reference files
- 如果需要 deterministic operations，创建 utility scripts
-
Review with user — 展示 draft 并询问：
- 是否覆盖你的 use cases？
- 是否缺失或不清楚？
- 是否有 section 应更详细或更简短？
More from vinvcn/mattpocock-skills-zh-cn
grill-me
围绕 plan 或 design 持续 interview user，直到达成 shared understanding，并逐一解决 decision tree 的每个分支。Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
131grill-with-docs
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
126tdd
使用 red-green-refactor loop 做 test-driven development。Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
125diagnose
面向棘手 bug 和性能回退的纪律化 diagnosis loop。Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
123setup-matt-pocock-skills
Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.
121zoom-out
让 agent zoom out，并给出更广的 context 或更高层 perspective。Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
120