Skip to content

ask-matt: map the full skill set, add router maintenance rule#406

Merged
mattpocock merged 2 commits into
mainfrom
ask-matt-full-skill-map
Jul 1, 2026
Merged

ask-matt: map the full skill set, add router maintenance rule#406
mattpocock merged 2 commits into
mainfrom
ask-matt-full-skill-map

Conversation

@mattpocock

Copy link
Copy Markdown
Owner

Why

ask-matt had drifted behind the skill set. It was missing five skills that now exist and are user-reachable — most notably there was no route for "something's broken."

What changed

skills/engineering/ask-matt/SKILL.md — now maps every promoted skill (13 engineering + 5 productivity):

  • /diagnosing-bugs — new "Something's broken" on-ramp.
  • /tdd — woven into the main flow as the red-green engine /implement drives, plus its direct-use case.
  • /domain-modeling + /codebase-design — new "Vocabulary underneath" section.
  • /grilling — noted as the shared primitive behind grill-me/grill-with-docs.
  • Fleshed out /prototype as a standalone; broadened the description from "user-invoked skills" to "the skills" (it always covered model-invoked ones too).

docs/engineering/ask-matt.md — re-synced the "What it does" framing (repo rule: change a skill's behaviour → re-sync its docs page).

CLAUDE.md — added a maintenance rule so any future skill add/rename/remove or flow change triggers an Ask Matt re-check, beside the existing docs-page re-sync rule.

Verification

Confirmed all 18 referenced skills resolve to real directories, and every promoted skill in the repo is now covered.

🤖 Generated with Claude Code

Ask Matt was missing five skills that now exist and are user-reachable:
tdd (the red-green engine implement drives), diagnosing-bugs (there was
no route for "something's broken"), domain-modeling and codebase-design
(the two vocabulary references), and grilling (the shared primitive).

- SKILL.md: add a "Something's broken" on-ramp for diagnosing-bugs, a
  "Vocabulary underneath" section for domain-modeling/codebase-design,
  weave tdd into the main flow, flesh out prototype, broaden the
  description from "user-invoked skills" to "the skills".
- docs/engineering/ask-matt.md: re-sync the framing to match.
- CLAUDE.md: add a maintenance rule so any future skill change triggers
  an Ask Matt re-check, beside the existing docs-page re-sync rule.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Jul 1, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 930a450

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
mattpocock-skills Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant