summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Pocock <mattpocockvoice@gmail.com>2026-07-28 10:16:53 +0100
committerMatt Pocock <mattpocockvoice@gmail.com>2026-07-28 10:17:03 +0100
commit369c264e230c1b6faf79853aae0150ef9362576b (patch)
tree1fc2a2061b076096f95018550f14668b2c1d9349
parented37663cc5fbef691ddfecd080dff42f7e7e350d (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.md63
1 files changed, 39 insertions, 24 deletions
diff --git a/README.md b/README.md
index 8cc7909..eb26335 100644
--- a/README.md
+++ b/README.md
@@ -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