diff --git a/CLAUDE.md b/CLAUDE.md index 24a0ca6..5d4f0ef 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,4 +6,8 @@ Skills are organized into bucket folders under `skills/`: - `personal/` — tied to my own setup, not promoted - `deprecated/` — no longer used -Every skill in `engineering/`, `productivity/`, or `misc/` must have a reference in `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `personal/` and `deprecated/` must not appear in either. +Every skill in `engineering/`, `productivity/`, or `misc/` must have a reference in the top-level `README.md` and an entry in `.claude-plugin/plugin.json`. Skills in `personal/` and `deprecated/` must not appear in either. + +Each skill entry in the top-level `README.md` must link the skill name to its `SKILL.md`. + +Each bucket folder has a `README.md` that lists every skill in the bucket with a one-line description, with the skill name linked to its `SKILL.md`. diff --git a/README.md b/README.md index 6daba43..32a9018 100644 --- a/README.md +++ b/README.md @@ -10,49 +10,49 @@ If you want to keep up with changes to these skills, and any new ones I create, Skills I use daily for code work. -- **diagnose** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test. +- **[diagnose](./skills/engineering/diagnose/SKILL.md)** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test. ``` npx skills@latest add mattpocock/skills/diagnose ``` -- **domain-model** — Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates `CONTEXT.md` and ADRs inline. +- **[domain-model](./skills/engineering/domain-model/SKILL.md)** — Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates `CONTEXT.md` and ADRs inline. ``` npx skills@latest add mattpocock/skills/domain-model ``` -- **github-triage** — Triage GitHub issues through a label-based state machine. +- **[github-triage](./skills/engineering/github-triage/SKILL.md)** — Triage GitHub issues through a label-based state machine. ``` npx skills@latest add mattpocock/skills/github-triage ``` -- **improve-codebase-architecture** — Find deepening opportunities in a codebase, informed by the domain language in `CONTEXT.md` and the decisions in `docs/adr/`. +- **[improve-codebase-architecture](./skills/engineering/improve-codebase-architecture/SKILL.md)** — Find deepening opportunities in a codebase, informed by the domain language in `CONTEXT.md` and the decisions in `docs/adr/`. ``` npx skills@latest add mattpocock/skills/improve-codebase-architecture ``` -- **tdd** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time. +- **[tdd](./skills/engineering/tdd/SKILL.md)** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time. ``` npx skills@latest add mattpocock/skills/tdd ``` -- **to-issues** — Break any plan, spec, or PRD into independently-grabbable GitHub issues using vertical slices. +- **[to-issues](./skills/engineering/to-issues/SKILL.md)** — Break any plan, spec, or PRD into independently-grabbable GitHub issues using vertical slices. ``` npx skills@latest add mattpocock/skills/to-issues ``` -- **to-prd** — Turn the current conversation context into a PRD and submit it as a GitHub issue. No interview — just synthesizes what you've already discussed. +- **[to-prd](./skills/engineering/to-prd/SKILL.md)** — Turn the current conversation context into a PRD and submit it as a GitHub issue. No interview — just synthesizes what you've already discussed. ``` npx skills@latest add mattpocock/skills/to-prd ``` -- **zoom-out** — Tell the agent to zoom out and give broader context or a higher-level perspective on an unfamiliar section of code. +- **[zoom-out](./skills/engineering/zoom-out/SKILL.md)** — Tell the agent to zoom out and give broader context or a higher-level perspective on an unfamiliar section of code. ``` npx skills@latest add mattpocock/skills/zoom-out @@ -62,19 +62,19 @@ Skills I use daily for code work. General workflow tools, not code-specific. -- **caveman** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy. +- **[caveman](./skills/productivity/caveman/SKILL.md)** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy. ``` npx skills@latest add mattpocock/skills/caveman ``` -- **grill-me** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved. +- **[grill-me](./skills/productivity/grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved. ``` npx skills@latest add mattpocock/skills/grill-me ``` -- **write-a-skill** — Create new skills with proper structure, progressive disclosure, and bundled resources. +- **[write-a-skill](./skills/productivity/write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources. ``` npx skills@latest add mattpocock/skills/write-a-skill @@ -84,25 +84,25 @@ General workflow tools, not code-specific. Tools I keep around but rarely use. -- **git-guardrails-claude-code** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute. +- **[git-guardrails-claude-code](./skills/misc/git-guardrails-claude-code/SKILL.md)** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute. ``` npx skills@latest add mattpocock/skills/git-guardrails-claude-code ``` -- **migrate-to-shoehorn** — Migrate test files from `as` type assertions to @total-typescript/shoehorn. +- **[migrate-to-shoehorn](./skills/misc/migrate-to-shoehorn/SKILL.md)** — Migrate test files from `as` type assertions to @total-typescript/shoehorn. ``` npx skills@latest add mattpocock/skills/migrate-to-shoehorn ``` -- **scaffold-exercises** — Create exercise directory structures with sections, problems, solutions, and explainers. +- **[scaffold-exercises](./skills/misc/scaffold-exercises/SKILL.md)** — Create exercise directory structures with sections, problems, solutions, and explainers. ``` npx skills@latest add mattpocock/skills/scaffold-exercises ``` -- **setup-pre-commit** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests. +- **[setup-pre-commit](./skills/misc/setup-pre-commit/SKILL.md)** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests. ``` npx skills@latest add mattpocock/skills/setup-pre-commit diff --git a/skills/deprecated/README.md b/skills/deprecated/README.md index 206f2bc..e570b71 100644 --- a/skills/deprecated/README.md +++ b/skills/deprecated/README.md @@ -1,3 +1,9 @@ # Deprecated Skills I no longer use. + +- **[design-an-interface](./design-an-interface/SKILL.md)** — Generate multiple radically different interface designs for a module using parallel sub-agents. +- **[qa](./qa/SKILL.md)** — Interactive QA session where user reports bugs conversationally and the agent files GitHub issues. +- **[request-refactor-plan](./request-refactor-plan/SKILL.md)** — Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. +- **[triage-issue](./triage-issue/SKILL.md)** — Investigate a bug by exploring the codebase, identify the root cause, and file a GitHub issue with a TDD-based fix plan. +- **[ubiquitous-language](./ubiquitous-language/SKILL.md)** — Extract a DDD-style ubiquitous language glossary from the current conversation. diff --git a/skills/engineering/README.md b/skills/engineering/README.md index af9c04d..63882e7 100644 --- a/skills/engineering/README.md +++ b/skills/engineering/README.md @@ -1,3 +1,12 @@ # Engineering Skills I use daily for code work. + +- **[diagnose](./diagnose/SKILL.md)** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test. +- **[domain-model](./domain-model/SKILL.md)** — Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates `CONTEXT.md` and ADRs inline. +- **[github-triage](./github-triage/SKILL.md)** — Triage GitHub issues through a label-based state machine. +- **[improve-codebase-architecture](./improve-codebase-architecture/SKILL.md)** — Find deepening opportunities in a codebase, informed by the domain language in `CONTEXT.md` and the decisions in `docs/adr/`. +- **[tdd](./tdd/SKILL.md)** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time. +- **[to-issues](./to-issues/SKILL.md)** — Break any plan, spec, or PRD into independently-grabbable GitHub issues using vertical slices. +- **[to-prd](./to-prd/SKILL.md)** — Turn the current conversation context into a PRD and submit it as a GitHub issue. +- **[zoom-out](./zoom-out/SKILL.md)** — Tell the agent to zoom out and give broader context or a higher-level perspective on an unfamiliar section of code. diff --git a/skills/misc/README.md b/skills/misc/README.md index a01f397..89e4cf3 100644 --- a/skills/misc/README.md +++ b/skills/misc/README.md @@ -1,3 +1,8 @@ # Misc Tools I keep around but rarely use. + +- **[git-guardrails-claude-code](./git-guardrails-claude-code/SKILL.md)** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute. +- **[migrate-to-shoehorn](./migrate-to-shoehorn/SKILL.md)** — Migrate test files from `as` type assertions to @total-typescript/shoehorn. +- **[scaffold-exercises](./scaffold-exercises/SKILL.md)** — Create exercise directory structures with sections, problems, solutions, and explainers. +- **[setup-pre-commit](./setup-pre-commit/SKILL.md)** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests. diff --git a/skills/personal/README.md b/skills/personal/README.md index 0ce876b..7884391 100644 --- a/skills/personal/README.md +++ b/skills/personal/README.md @@ -1,3 +1,6 @@ # Personal Skills tied to my own setup, not promoted in the plugin. + +- **[edit-article](./edit-article/SKILL.md)** — Edit and improve articles by restructuring sections, improving clarity, and tightening prose. +- **[obsidian-vault](./obsidian-vault/SKILL.md)** — Search, create, and manage notes in an Obsidian vault with wikilinks and index notes. diff --git a/skills/productivity/README.md b/skills/productivity/README.md index 83b735f..d066058 100644 --- a/skills/productivity/README.md +++ b/skills/productivity/README.md @@ -1,3 +1,7 @@ # Productivity General workflow tools, not code-specific. + +- **[caveman](./caveman/SKILL.md)** — Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler while keeping full technical accuracy. +- **[grill-me](./grill-me/SKILL.md)** — Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved. +- **[write-a-skill](./write-a-skill/SKILL.md)** — Create new skills with proper structure, progressive disclosure, and bundled resources.