From 1325b1464becee8db785260b5f556e641b8e7f55 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Wed, 18 Mar 2026 14:17:16 +0000 Subject: [PATCH] Add installation commands --- README.md | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 90 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index efe6a2e..88bed7f 100644 --- a/README.md +++ b/README.md @@ -7,22 +7,111 @@ A collection of agent skills that extend capabilities across planning, developme These skills help you think through problems before writing code. - **write-a-prd** — Create a PRD through an interactive interview, codebase exploration, and module design. Filed as a GitHub issue. + + ``` + npx skills@latest add mattpocock/skills/write-a-prd + ``` + +- **prd-to-plan** — Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices. + + ``` + npx skills@latest add mattpocock/skills/prd-to-plan + ``` + - **prd-to-issues** — Break a PRD into independently-grabbable GitHub issues using vertical slices. + + ``` + npx skills@latest add mattpocock/skills/prd-to-issues + ``` + - **grill-me** — 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 + ``` + +- **design-an-interface** — Generate multiple radically different interface designs for a module using parallel sub-agents. + + ``` + npx skills@latest add mattpocock/skills/design-an-interface + ``` + +- **request-refactor-plan** — Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. + + ``` + npx skills@latest add mattpocock/skills/request-refactor-plan + ``` + ## Development These skills help you write, refactor, and fix code. - **tdd** — 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 + ``` + - **triage-issue** — Investigate a bug by exploring the codebase, identify the root cause, and file a GitHub issue with a TDD-based fix plan. + + ``` + npx skills@latest add mattpocock/skills/triage-issue + ``` + - **improve-codebase-architecture** — Explore a codebase for architectural improvement opportunities, focusing on deepening shallow modules and improving testability. + ``` + npx skills@latest add mattpocock/skills/improve-codebase-architecture + ``` + +- **migrate-to-shoehorn** — 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. + + ``` + npx skills@latest add mattpocock/skills/scaffold-exercises + ``` + ## Tooling & Setup - **setup-pre-commit** — Set up Husky pre-commit hooks with lint-staged, Prettier, type checking, and tests. + + ``` + npx skills@latest add mattpocock/skills/setup-pre-commit + ``` + - **git-guardrails-claude-code** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, etc.) before they execute. -## Writing Skills + ``` + npx skills@latest add mattpocock/skills/git-guardrails-claude-code + ``` + +## Writing & Knowledge - **write-a-skill** — Create new skills with proper structure, progressive disclosure, and bundled resources. + + ``` + npx skills@latest add mattpocock/skills/write-a-skill + ``` + +- **edit-article** — Edit and improve articles by restructuring sections, improving clarity, and tightening prose. + + ``` + npx skills@latest add mattpocock/skills/edit-article + ``` + +- **ubiquitous-language** — Extract a DDD-style ubiquitous language glossary from the current conversation. + + ``` + npx skills@latest add mattpocock/skills/ubiquitous-language + ``` + +- **obsidian-vault** — Search, create, and manage notes in an Obsidian vault with wikilinks and index notes. + + ``` + npx skills@latest add mattpocock/skills/obsidian-vault + ```