--- title: "Promoted skill catalog" type: entity tags: [catalog, invocation, foundational, well-established] created: 2026-08-02 updated: 2026-08-02 sources: ["raw/github_doc-readme-md.md", "raw/github_doc-skills-engineering-ask-matt-skill-md.md", "raw/github_doc-skills-engineering-code-review-skill-md.md", "raw/github_doc-skills-engineering-codebase-design-skill-md.md", "raw/github_doc-skills-engineering-diagnosing-bugs-skill-md.md", "raw/github_doc-skills-engineering-domain-modeling-skill-md.md", "raw/github_doc-skills-engineering-grill-with-docs-skill-md.md", "raw/github_doc-skills-engineering-implement-skill-md.md", "raw/github_doc-skills-engineering-improve-codebase-architecture-skill-md.md", "raw/github_doc-skills-engineering-prototype-skill-md.md", "raw/github_doc-skills-engineering-research-skill-md.md", "raw/github_doc-skills-engineering-resolving-merge-conflicts-skill-md.md", "raw/github_doc-skills-engineering-setup-matt-pocock-skills-skill-md.md", "raw/github_doc-skills-engineering-tdd-skill-md.md", "raw/github_doc-skills-engineering-to-spec-skill-md.md", "raw/github_doc-skills-engineering-to-tickets-skill-md.md", "raw/github_doc-skills-engineering-triage-skill-md.md", "raw/github_doc-skills-engineering-wayfinder-skill-md.md", "raw/github_doc-skills-productivity-grill-me-skill-md.md", "raw/github_doc-skills-productivity-grilling-skill-md.md", "raw/github_doc-skills-productivity-handoff-skill-md.md", "raw/github_doc-skills-productivity-teach-skill-md.md", "raw/github_doc-skills-productivity-writing-great-skills-skill-md.md"] confidence: high skills_snapshot: "2ab958093e83e0ec752e6c1c5932da465bf23e0c" --- # Promoted skill catalog ## Overview The Claude Code plugin manifest is the supported inventory for this repo: 22 skill directories, split 17 engineering + 5 productivity, at snapshot `2ab958093e83e0ec752e6c1c5932da465bf23e0c`. This is the navigation hub for that inventory — each skill now has its own entity page grounded in its own `SKILL.md`; this page just points to them. **Invocation class** follows the mechanism described in [[concepts/concepts-and-invocation]]: a skill's own frontmatter carries `disable-model-invocation: true` when it is **User-invoked** (reachable only by typing it); the flag is absent when it is **Model-invoked** (reachable by typing it, or automatically when the task fits). ## Characteristics ### Engineering (17) | Skill | Purpose | Invocation class | Page | |---|---|---|---| | `ask-matt` | Router over which skill or flow fits your situation. | User-invoked | [[entities/ask-matt]] | | `grill-with-docs` | Relentless interview to sharpen a plan/design; creates ADRs and glossary entries as it goes. | User-invoked | [[entities/grill-with-docs]] | | `triage` | Moves issues and external PRs through a state machine of triage roles, producing agent-ready briefs. | User-invoked | [[entities/triage]] | | `improve-codebase-architecture` | Scans a codebase for deepening opportunities, presents a visual HTML report, then grills through the pick. | User-invoked | [[entities/improve-codebase-architecture]] | | `setup-matt-pocock-skills` | Configures a repo's issue tracker, triage labels, and domain-doc layout. Run once first. | User-invoked | [[entities/setup-matt-pocock-skills]] | | `to-spec` | Synthesizes the current conversation into a spec, published to the issue tracker. | User-invoked | [[entities/to-spec]] | | `to-tickets` | Breaks a plan/spec into tracer-bullet tickets with declared blocking edges. | User-invoked | [[entities/to-tickets]] | | `implement` | Implements a spec or set of tickets, driving TDD and code-review internally. | User-invoked | [[entities/implement]] | | `wayfinder` | Plans huge, foggy efforts as a shared map of decision tickets, resolved one at a time. | User-invoked | [[entities/wayfinder]] | | `prototype` | Builds a throwaway prototype to answer a design question. | Model-invoked | [[entities/prototype]] | | `diagnosing-bugs` | Six-phase diagnosis loop for hard bugs and performance regressions. | Model-invoked | [[entities/diagnosing-bugs]] | | `research` | Delegates reading legwork to a background agent, citing primary sources. | Model-invoked | [[entities/research]] | | `tdd` | Reference for the red-green loop — good tests, seams, anti-patterns, loop rules. | Model-invoked | [[entities/tdd]] | | `domain-modeling` | Actively builds and sharpens a project's domain model — glossary and ADRs. | Model-invoked | [[entities/domain-modeling]] | | `codebase-design` | Shared vocabulary for designing deep modules — interface, depth, seam, adapter. | Model-invoked | [[entities/codebase-design]] | | `code-review` | Two-axis review (Standards + Spec) of a diff, run as parallel sub-agents. | Model-invoked | [[entities/code-review]] | | `resolving-merge-conflicts` | Resolves an in-progress git merge/rebase conflict by intent, then verifies. | Model-invoked | [[entities/resolving-merge-conflicts]] | ### Productivity (5) | Skill | Purpose | Invocation class | Page | |---|---|---|---| | `grill-me` | The same relentless interview as `grill-with-docs`, but stateless — for when there's no codebase. | User-invoked | [[entities/grill-me]] | | `handoff` | Compacts the current conversation into a handoff document for another agent/session to pick up. | User-invoked | [[entities/handoff]] | | `teach` | Teaches the user a new skill or concept, using the current workspace as stateful context. | User-invoked | [[entities/teach]] | | `writing-great-skills` | Reference for writing and editing skills well — the vocabulary of a predictable skill. | User-invoked | [[entities/writing-great-skills]] | | `grilling` | The reusable interview primitive underneath both `grill-me` and `grill-with-docs`. | Model-invoked | [[entities/grilling]] | **Totals: 17 engineering + 5 productivity = 22 promoted skills**, matching the README's Reference section and each skill's own frontmatter. ## How to Use Start from [[concepts/overview]] for what the collection is, or [[concepts/installation-and-distribution]] to get the skills installed and the repository configured. Use the tables above to jump straight to a skill's own entity page for its full Overview / Characteristics / How to Use / Related Entities — this hub intentionally stays high-level. [[concepts/workflow-recipes]] shows how several of these compose into end-to-end chains (idea → ship, an incoming issue, a hard bug, a large initiative); [[entities/ask-matt]] is the router skill that performs the same job inside a live session. This catalog is scoped to the 22 promoted skills only. The repository also contains `in-progress/` and `misc/` skill buckets present in the source tree but not part of the plugin's promoted Reference list at this snapshot — see [[concepts/governance-and-limitations]] for why those are excluded here and how the promoted boundary has shifted between releases. ## Related Entities - [[entities/ask-matt]] — the in-session router over this same 22-skill inventory. - [[concepts/concepts-and-invocation]] — the invocation-class mechanism this table's middle column is built on. - [[concepts/workflow-recipes]] — recipes that chain several of these skills together. - [[concepts/overview]] — what the collection is and the promoted-vs-present distinction. - [[concepts/installation-and-distribution]] — how to get these 22 skills installed and configured. - [[concepts/governance-and-limitations]] — why non-promoted buckets (`in-progress/`, `misc/`) are excluded, and how the promoted set has changed across releases.