Matt PocockandClaude Opus 5
ad98b80dbd
- install-block.md: state the invariant as a requirement rather than as already-true (docs/ is brought into line downstream); mark all three canonical snippets, not just the Claude Code one; pin the `skills@latest` spelling; restore the `setup-matt-pocock-skills` instruction the whole-set form carries; cite the docs source for the auto-update claim. - writing-docs.md: say plainly that the template's Quickstart is the older wording, so the file no longer contradicts itself. - CLAUDE.md: split the paragraph, stop restating the fallback rationale. - ADR 0002: record what was actually verified, on which version, and the two things that were not — the pinned sha in the official listing, and the in-session slash command. Refs mattpocock/personal-wiki#250 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2.6 KiB
The canonical install block
One install story, one wording. README.md, .changeset/*, and every page under docs/ must say this and nothing else. Change it here first, then propagate.
mattpocock-skills is listed in Claude Code's official marketplace — configured name claude-plugins-official, source repo anthropics/claude-plugins-official — which every Claude Code install has out of the box. There is no marketplace to add first. Official Anthropic marketplaces have auto-update enabled by default (discover-plugins), so "updates arrive automatically" is a true claim, not a hope.
Claude Code — the plugin
claude plugins install mattpocock-skills
Or, from inside a session:
/plugin install mattpocock-skills
It's in Claude Code's official marketplace, so there's nothing to add first, and updates arrive automatically.
Codex, and other agents — skills.sh
The plugin is Claude Code only. Everywhere else, skills.sh copies editable skill files into the project. Use the whole-set form on README.md:
npx skills@latest add mattpocock/skills
Pick the skills you want, and which coding agents to install them on. The installer lets you choose which skills to take — make sure setup-matt-pocock-skills is one of them.
…and the single-skill form on a docs/ page, where the page already names one skill:
npx skills@latest add mattpocock/skills --skill=<name>
npx skills@latest update <name>
skills@latest is the pinned spelling in all three. The Quickstart template in writing-docs.md, and the 24 pages under docs/, still carry the older bare npx skills …; the docs pass brings them into line.
The two routes are exclusive
The plugin is a managed, read-only bundle you subscribe to. skills.sh writes files you own and edit. Installing both leaves the user with every skill twice — always say "pick one".
Not the install story
.claude-plugin/marketplace.json makes the repo its own single-plugin marketplace (/plugin marketplace add mattpocock/skills, then /plugin install mattpocock-skills@mattpocock). The official listing supersedes it. It is kept as a fallback for installing the repo directly — an unreleased commit, or a fork — and is not documented to users.