Matt PocockandClaude Opus 5
c474642895
mattpocock-skills is now listed in Claude Code's official marketplace, so the own-marketplace route is superseded. The queued changeset still documented it, and changeset bodies ship verbatim into CHANGELOG.md — the release would have published a superseded install route as its headline. - Rewrite .changeset/ship-as-claude-plugin.md around `claude plugins install mattpocock-skills`. - Add .agents/install-block.md as the single source for install wording, so the docs pass has one true thing to copy. - Point .agents/writing-docs.md and CLAUDE.md at it. - Note the official listing in ADR 0002, and record that it reads plugin.json directly and does not depend on marketplace.json. .claude-plugin/marketplace.json is kept as a fallback for direct-repo installs; nothing in CI or scripts references it. Refs mattpocock/personal-wiki#250 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1.7 KiB
The canonical install block
One install story, one wording. README.md, .changeset/*, and every page under docs/ say this and nothing else. If the install route changes, change it here first, then propagate.
mattpocock-skills is listed in Claude Code's official marketplace (claude-plugins-official), which every Claude Code install has configured out of the box. There is no marketplace to add first, and official-marketplace plugins auto-update in the background.
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:
npx skills@latest add mattpocock/skills
For a single skill, npx skills add mattpocock/skills --skill=<name>; to refresh it later, npx skills update <name>.
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.