Files
skills/.changeset/flat-skills-tree.md
T
Matt PocockandClaude Opus 5 a16a2674bc refactor: flatten skills/ and adopt Agent Plugins 1.0
The Agent Plugins standard reads only the immediate children of
skills/ and cannot be pointed elsewhere, so a bucketed tree is
invisible to every conformant client.

Rather than generate a flat copy of the repo into a package
directory — a builder, a validator, an allowlist, a drift CI job,
and every skill committed twice — remove the buckets.

- skills/ is flat and holds exactly the promoted 25
- in-progress/ -> drafts/, misc/ -> extras/, deprecated/ deleted
- new root plugin.json (Agent Plugins 1.0)
- .claude-plugin/plugin.json loses its 25-entry skills array
- docs/ keeps its category folders; it is now the only place a
  skill's category lives

Reasoning in .agents/adr/0003.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 16:50:39 +01:00

1.2 KiB

mattpocock-skills
mattpocock-skills
patch

Flatten skills/ so the repo conforms to the Agent Plugins 1.0 standard, which reads only the immediate children of skills/ and can't be pointed anywhere else.

Nothing changes for installed users: same plugin name, same 25 skills, same slash commands, same install commands. Source paths moved, so anything pinning a skills/engineering/… or skills/productivity/… path needs updating.

  • Promoted skills are now flat at skills/<name>/. Which folder a skill lives in is the only thing that decides whether it ships.
  • in-progress/drafts/, misc/extras/, both outside skills/. deprecated/ is deleted; it was empty.
  • New plugin.json at the repo root — the Agent Plugins 1.0 manifest, read by Codex, Cursor and Copilot.
  • .claude-plugin/plugin.json keeps serving Claude Code, which doesn't implement the standard yet, and loses its 25-entry skills array.
  • npx skills@latest add mattpocock/skills now offers the promoted 25 only. It was quietly offering all 35, drafts included.

The reasoning, and the generated-package approach we rejected, are in ADR 0003.