skills/CHANGELOG.md

mattpocock-skills

1.1.0

Minor Changes

• 850873c Thanks @mattpocock! - Make the prototype skill model-invoked, so the agent can reach for it autonomously (and other skills can too). Its description is rewritten around the leading word prototype — throwaway code that answers a design question — with one trigger per branch (state/logic sanity-check, or UI exploration).

Patch Changes

• #394 7a4c756 Thanks @mattpocock! - Give the in-progress review skill an always-on Fowler smell baseline on its Standards axis. A curated ~12 high-signal "Bad Smells in Code" (Mysterious Name, Duplicated Code, Feature Envy, Data Clumps, Primitive Obsession, Repeated Switches, Shotgun Surgery, Divergent Change, Speculative Generality, Message Chains, Middle Man, Refused Bequest) are inlined into SKILL.md as a fixed baseline alongside whatever the repo documents — not a new third axis. Two binding rules keep it safe: a documented repo standard overrides the baseline, and every smell is reported as a judgement call, never a hard violation.

• 43ea088 Thanks @mattpocock! - Add the tautological test anti-pattern to the tdd skill. Tests whose assertion is recomputed the way the code computes it pass by construction and give zero confidence — distinct from the implementation-coupling anti-pattern already covered. Added as a peer at the same three sites: a Philosophy principle (expected values must come from an independent source of truth), a per-cycle checklist gate, and a BAD/GOOD example pair in tests.md.

• e00eadb Thanks @mattpocock! - Extend the triage skill to triage external pull requests, treating a PR as an issue with attached code that runs through the same roles and state machine. PRs flow inline alongside issues (gated by a per-repo setup toggle), discovery surfaces only external PRs, the bug-only "reproduce" step is generalized into a single "verify the claim" step, and a redundancy check resolves already-implemented requests to wontfix without polluting the out-of-scope knowledge base. setup-matt-pocock-skills gains the PRs-as-a-request-surface toggle for GitHub/GitLab.

1.0.1

Patch Changes

• d20ee26 Thanks @mattpocock! - Make the teach skill reuse-first. Lessons are now built from reusable components in ./assets/ — stylesheets, quiz widgets, simulators, diagram helpers. Reuse is the default: the agent reads ./assets/ before authoring a lesson, builds from what's there, and extracts anything new and reusable into a component rather than inlining it.

1.0.0

Major Changes

• 47bde84 Thanks @mattpocock! - Add the ask-matt skill — a user-invoked router that points you at the right skill or flow for your situation.

  Breaking: ask-matt routes over the other user-invoked skills in this repo, so it expects them to be installed.

• 47bde84 Thanks @mattpocock! - Add the shared design skills and rewire existing skills onto them.

  • New codebase-design skill — the deep-module vocabulary (module, interface, depth, seam, adapter) and the principles for putting a lot of behaviour behind a small interface. The language that previously lived in improve-codebase-architecture/LANGUAGE.md now lives here, generalized for reuse across skills.
  • New domain-modeling skill — actively build and sharpen a project's domain model, stress-testing terms against the glossary and keeping CONTEXT.md and ADRs current.
  • improve-codebase-architecture now draws its architecture vocabulary from /codebase-design and its domain model from /domain-modeling.
  • tdd now leans on /codebase-design for interface-design guidance — its inline deep-modules.md / interface-design.md notes were removed in favour of the shared skill.
  • grill-with-docs now builds the domain model inline via /domain-modeling.

  Breaking: these skills now depend on the new codebase-design / domain-modeling skills, so you must install them too.

• 47bde84 Thanks @mattpocock! - Remove the caveman and zoom-out skills.

  • caveman was a duplicate of another skill I was testing and was never meant to be public.
  • zoom-out went unused in practice, so it's been removed from the repo.

  Breaking: both skills have been removed.

• 47bde84 Thanks @mattpocock! - Rename the diagnose skill to diagnosing-bugs.

  Breaking: invoke it as /diagnosing-bugs — the old /diagnose name no longer exists.

• 47bde84 Thanks @mattpocock! - Replace write-a-skill with writing-great-skills.

  • Removed write-a-skill.
  • Added writing-great-skills (plus its GLOSSARY.md) — a reference for writing and editing skills well: the vocabulary and principles that make a skill predictable, hunting no-ops down to the sentence level.
  • Exposed grilling as a model-invoked skill — the reusable interview loop behind grill-me and grill-with-docs.

  Breaking: write-a-skill has been removed; use writing-great-skills instead.

Minor Changes

• 47bde84 Thanks @mattpocock! - Add the resolving-merge-conflicts skill — a loop for resolving an in-progress git merge or rebase conflict. Standalone, with no dependencies on other skills.

• 47bde84 Thanks @mattpocock! - Rename the skill taxonomy from Commands / Skills to User-invoked / Model-invoked across the docs, and add docs/invocation.md defining the split: user-invoked skills are reachable only when you type them and exist to orchestrate; model-invoked skills can also be reached automatically when the task fits. A user-invoked skill may invoke model-invoked skills, but never another user-invoked one.

Patch Changes

• 47bde84 Thanks @mattpocock! - Tighten the review skill: fail-fast ref check, single-sourced rules, and no-op cuts.