playbook/matt-pocock-skills/.changeset/skill-tool-invocation-terminology.md

mattpocock-skills

mattpocock-skills
patch

Standardize cross-skill invocation on an explicit "call the Skill tool" instruction instead of bare /skill-style prose, across code-review, diagnosing-bugs, grill-with-docs, grill-me, improve-codebase-architecture, tdd, to-spec, to-tickets, triage, and wayfinder.

• A skill that names another skill in prose ("run the /grilling skill") does not reliably cause it to load. This is the documented rough edge behind grill-with-docs's most-reported problem. Naming the tool directly (Call the Skill tool with "grilling") is intended to raise the hit rate. Dropping the leading / also makes the instruction harness-neutral rather than less: it no longer assumes Claude Code's trigger syntax.
• A step needing more than one skill now says so as multiple calls ("Call the Skill tool twice, for grilling and domain-modeling"), not one call carrying two names.
• Documents the convention in .agents/invocation.md for future skills to follow.