Architecture decision record explaining why the collection ships as a Claude Code plugin and why no Codex plugin exists yet. Useful context for anyone packaging their own skills for more than one harness.

Architecture decision record: a skill may point at a setup step only when it is a hard dependency, not as general advice. Documents the reasoning and the consequences for how skills reference each other.

The canonical install instructions, copied verbatim wherever installation is documented so the steps never drift between README and docs. Covers the Claude Code plugin route and the marketplace fallback.

Template and procedure for the human-facing docs page every promoted skill carries. Fixes the four required sections — what it does, when to reach for it, common questions, it's working if — plus section order and where to source the questions.

Defines the two invocation modes every SKILL.md must declare: user-invoked, reachable only by a human via slash command, or model-invoked, which the agent may trigger on its own. Explains the frontmatter and the openai.yaml policy flags that enforce each.

The router skill: maps every user-reachable skill and how they relate, so an agent can pick the right one instead of guessing. Kept in sync whenever a skill is added, renamed or removed, on the principle that a router which lies is worse than none.

Shared domain vocabulary for the repository. Defines Issue tracker, Issue, Decision ticket and Triage role, lists the terms to avoid, maps how the entities relate and records resolved ambiguities, so agent and human use one language instead of drifting synonyms.

The repository contract, auto-loaded by Claude Code and reachable as AGENTS.md through a symlink so Codex-style agents read the same file. Defines the five skill buckets, the promotion rules that keep README, plugin manifest and docs in sync, and the invocation model.

Index of the productivity bucket: seven skills for non-code workflow, each linked to its SKILL.md. Covers grill-me, grilling, handoff, teach, to-questionnaire, wait-what and writing-for-agents.

Index of the engineering bucket: eighteen skills for daily code work, each with a one-line description linked to its SKILL.md. Includes tdd, code-review, diagnosing-bugs, codebase-design, domain-modeling, implement, research, triage and wayfinder.

Full release history of the skills collection, maintained with changesets. Records every skill added, renamed, promoted between buckets or deprecated, which is the fastest way to see how the set has evolved and what is currently moving.

Front door of the pack: what these skills are, how to install them into Claude Code or another harness, and a linked index of all promoted skills split into user-invoked and model-invoked. Start here to see what the collection actually contains.

Navigation across mattpocock/skills with measured metrics: 101 markdown files out of 151, 88% of the repo by bytes, 35 SKILL.md across five buckets. Covers the promotion contract, the user-invoked vs model-invoked split, the AGENTS.md symlink trick and a single MIT license zone.