diff options
| author | Matt Pocock <mattpocockvoice@gmail.com> | 2026-07-28 10:16:53 +0100 |
|---|---|---|
| committer | Matt Pocock <mattpocockvoice@gmail.com> | 2026-07-28 10:17:03 +0100 |
| commit | 369c264e230c1b6faf79853aae0150ef9362576b (patch) | |
| tree | 1fc2a2061b076096f95018550f14668b2c1d9349 | |
| parent | ed37663cc5fbef691ddfecd080dff42f7e7e350d (diff) | |
docs: split install instructions by audiencedocs/install-instructions-split
Collapse the skills.sh Quickstart and the "Install as a Claude Code
plugin" section into one Installation section, ordered Claude Code →
Codex/other agents → tinkerers, each in a collapsed details block.
Claude Code now leads with the one-liner `claude plugins install
mattpocock-skills` — the plugin ships in Claude Code's official
marketplace, so the old two-step `marketplace add` → `install` dance is
gone.
`/setup-matt-pocock-skills` is promoted to a shared step 2, since every
install path needs it.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
| -rw-r--r-- | README.md | 63 |
1 files changed, 39 insertions, 24 deletions
@@ -22,49 +22,64 @@ If you want to keep up with changes to these skills, and any new ones I create, [Sign Up To The Newsletter](https://www.aihero.dev/s/skills-newsletter) -## Quickstart (30-second setup) +## Installation (30-second setup) -1. Run the skills.sh installer: +Two ways in, two philosophies. **The [Claude Code plugin](https://code.claude.com/docs/en/plugins)** installs the whole set as a managed, read-only bundle that updates when I ship — you subscribe rather than fork. **[skills.sh](https://skills.sh/mattpocock/skills)** copies editable skill files into your project, so you can hack on them and make them your own. Pick one — installing both leaves you with every skill twice. + +### 1. Get the skills + +<details> +<summary><strong>Claude Code</strong></summary> ```bash -npx skills@latest add mattpocock/skills +claude plugins install mattpocock-skills ``` -2. Pick the skills you want, and which coding agents you want to install them on. **Make sure you select `/setup-matt-pocock-skills`**. - -3. Run `/setup-matt-pocock-skills` in your agent. It will: - - Ask you which issue tracker you want to use (GitHub, Linear, or local files) - - Ask you what labels you apply to tickets when you triage them (`/triage` uses labels) - - Ask you where you want to save any docs we create +Or, from inside a session: -4. Bam - you're ready to go. +``` +/plugin install mattpocock-skills +``` -## Install as a Claude Code plugin +It's in Claude Code's official marketplace, so there's nothing to add first, and updates arrive automatically. -Prefer a plug-and-play install you don't maintain by hand? These skills also ship as a native [Claude Code plugin](https://code.claude.com/docs/en/plugins). Instead of copying editable files into your repo, the plugin installs the whole skill set as a managed bundle that updates when I ship a new version — you subscribe rather than fork. +</details> -Inside Claude Code: +<details> +<summary><strong>Codex, and other agents</strong></summary> +```bash +npx skills@latest add mattpocock/skills ``` -/plugin marketplace add mattpocock/skills -/plugin install mattpocock-skills@mattpocock -``` -Or from your shell: +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.** + +A native Codex plugin is on the roadmap — see [`.agents/adr/0002-ship-as-a-claude-code-plugin.md`](./.agents/adr/0002-ship-as-a-claude-code-plugin.md). + +</details> + +<details> +<summary><strong>For tinkerers</strong></summary> + +Use the same installer, on any agent — including Claude Code: ```bash -claude plugin marketplace add mattpocock/skills -claude plugin install mattpocock-skills@mattpocock +npx skills@latest add mattpocock/skills ``` -Then run `/setup-matt-pocock-skills` once per repo, exactly as in the quickstart above. +It writes the skills into your repo as ordinary files you own and can edit. Nothing updates behind your back; pull my latest changes when you want them with `npx skills update`. + +</details> + +### 2. Run `/setup-matt-pocock-skills` -Two ways to install, two philosophies: +In your agent, run it once per repo. It will: -- **[skills.sh](https://skills.sh/mattpocock/skills)** copies the skills into your project so you can hack on them and make them your own. -- **The plugin** keeps them as a read-only, always-current bundle you don't edit — best when you just want my set to work and follow along as it evolves. +- Ask you which issue tracker you want to use (GitHub, Linear, or local files) +- Ask you what labels you apply to tickets when you triage them (`/triage` uses labels) +- Ask you where you want to save any docs we create -> Using Codex or another agent? The [skills.sh installer](https://skills.sh/mattpocock/skills) already installs these skills into Codex and other Agent-Skills-standard harnesses today. A native Codex plugin is on the roadmap — see [`.agents/adr/0002-ship-as-a-claude-code-plugin.md`](./.agents/adr/0002-ship-as-a-claude-code-plugin.md). +### 3. Bam - you're ready to go. ## Why These Skills Exist |
