KrishP147 · Oct 17, 2026 · Oct 17, 2026 · Oct 17, 2026 · Oct 17, 2026 · Oct 17, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,7 @@ version in [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json);
 
 ## [0.1.0] - 2026-10-15
 
+- `install-skills --skill <name>` / `-Skill <name>` (#233) installs one skill, agent or hook plus what it needs; `--list-skills` / `-ListSkills` lists the names. Combines with `--workflow`. Optional companions are no longer pulled in (e.g. `find-me-a-skill` no longer brings `meta-orchestrator`; `pr-watch` fixes inline without `pair`). Each README says "Works on its own." or what it needs, each site page shows its one-line install, and a test installs every entry alone and checks it links to nothing missing.
 - `/switch setup [name]` (#234) runs first-time setup from inside Claude: it shows the profile and settings diff (`setup --dry-run`, new), asks in chat, then writes with `--yes` and says to open a new terminal. `name` names the config dir you're on (`$CLAUDE_CONFIG_DIR`, else `~/.claude`; `main` by default) and is refused when that dir or name is already registered differently. Falls back to `python` when `python3` is the Windows Store stub. The README's first-time steps lead with it; the shell command stays as the fallback.
 - `/switch list` (#230) shows per account whether it is logged in (`.credentials.json`, or on macOS an `oauthAccount` in `.claude.json`; never the Keychain), its email, and the last seen session and weekly usage with time left (`-` without a cache, `0%` past a reset). The hook answers `/switch list` itself, launcher or not, so it makes no API call and works at 100%.
 - Workflows `unattended-backlog`, `climb-a-score` and `safe-to-close` gain `/switch` and `/remind` steps for usage limits (#235).

diff --git a/README.md b/README.md
@@ -228,6 +228,18 @@ The lint step needs a real Python 3 on `PATH` (`python`, `python3`, or — on Wi
 
 If a directory with the same name as one of this repo's skills already exists under `~/.claude/skills/` but has no `.from-krishp147-skills` marker (i.e. you didn't get it from here), the install leaves it untouched, warns, and exits non-zero at the end so you notice. Pass `--force` (sh) / `-Force` (ps1) to replace it anyway. Upgrading from an install made before the marker existed? Every old skill dir looks foreign, so run once with `--force` / `-Force`.
 
+#### Install one skill
+
+Want just one skill, agent or hook, like `switch`? Name it:
+
+```bash
+./scripts/install-skills.sh --list-skills                    # every name and its kind
+./scripts/install-skills.sh --skill switch                   # repeat --skill for more
+.\scripts\install-skills.ps1 -Skill switch,planner           # Windows PowerShell
+```
+
+Anything it needs comes with it, and its README says what that is on the line under the title ("Works on its own." or "Needs: ..."). `--skill` and `--workflow` can be combined; you get both. Everything below about partial installs applies to `--skill` too.
+
 #### Install one workflow
 
 To take only what one [sample workflow](https://www.krishpunjabi.com/skills/workflows) uses instead of everything:

diff --git a/agents/README.md b/agents/README.md
@@ -18,6 +18,8 @@ Installed by `scripts/install-skills.*` into `~/.claude/agents/`, with `hooks/`
 
 ## planner
 
+Needs: `divide`, `next` (installed with it).
+
 - **Role:** picks the next single unit of work from the board and writes the kickoff brief.
   - Read-only: `disallowedTools: Edit, Write, NotebookEdit`; never creates issues.
   - `maxTurns: 40`.
@@ -57,6 +59,8 @@ Installed by `scripts/install-skills.*` into `~/.claude/agents/`, with `hooks/`
 
 ## manager
 
+Needs: `handoff-auto`, `kanban-setup`, `next`, `session-handoff`, `implementer` (installed with it).
+
 - **Role:** owns one task end to end in a worktree.
   - Never implements itself: briefs an implementer, then reviews its work as if it didn't trust it.
   - `maxTurns: 150`.
@@ -109,6 +113,8 @@ Installed by `scripts/install-skills.*` into `~/.claude/agents/`, with `hooks/`
 
 ## implementer
 
+Needs: `handoff-auto`, `kanban-setup`, `next`, `session-handoff` (installed with it).
+
 - **Role:** implements one well-specified issue from a kickoff brief on its own branch.
   - `maxTurns: 200`.
 - **You pass:** the kickoff brief verbatim + branch prefix + protected branch + `decisions` (from `manager` or the orchestrator).
@@ -143,6 +149,8 @@ Installed by `scripts/install-skills.*` into `~/.claude/agents/`, with `hooks/`
 
 ## verifier
 
+Needs: `consult-plan`, `next`, `update-progress` (installed with it).
+
 - **Role:** verifies an implementation session and closes the loop.
   - `maxTurns: 120`.
   - No guard hook.

diff --git a/find-me-a-skill/README.md b/find-me-a-skill/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Tells you which skill or sample workflow fits a task, which model and

diff --git a/find-me-a-skill/SKILL.md b/find-me-a-skill/SKILL.md
@@ -12,7 +12,7 @@ Read-only: suggest, never invoke a skill, agent or tool that changes anything. T
 First that applies:
 - Text after the command.
 - The goal of this conversation so far.
-- The top 1-3 board tasks, found as the `next` skill's `BOARD.md` says (`~/.claude/skills/next/` or, as the plugin, `kanban/next/`); give one suggestion per task.
+- The top 1-3 board tasks, found as the `next` skill's `BOARD.md` says (`~/.claude/skills/next/` or, as the plugin, `kanban/next/`); give one suggestion per task. No `next` skill installed: skip this line.
 - No repo or no board: ask what the task is, then stop.
 
 ## 2. Options (at most 3)

diff --git a/gap-scan/README.md b/gap-scan/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto`, `next` (installed with it).
+
 ## What it does
 
 Surveys one or more repos — code, recent commits, docs, open issues, and

diff --git a/grill-docs/README.md b/grill-docs/README.md
@@ -2,6 +2,8 @@
 
 *Original. Wraps Matt Pocock's `grilling` (MIT). `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `consult-plan`, `handoff-auto`, `next` (installed with it).
+
 ## What it does
 
 Runs the `grilling` interview on a plan or decision and leaves a paper trail in the repo: the full question → recommendation → answer transcript, and one row per settled decision in an append-only register. Everything else about the interview is unchanged.

diff --git a/grill-me/README.md b/grill-me/README.md
@@ -2,6 +2,8 @@
 
 *By Matt Pocock (MIT), included verbatim. `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Short alias for [`grilling`](../grilling/): a relentless interview to sharpen a plan or design.

diff --git a/grilling/README.md b/grilling/README.md
@@ -2,6 +2,8 @@
 
 *By Matt Pocock (MIT), included verbatim. `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Interviews you, one round at a time, until a plan or decision has no unexamined branches left. Every question comes with Claude's recommended answer, so you can just say "yes" to most.

diff --git a/handoff-auto/README.md b/handoff-auto/README.md
@@ -2,6 +2,8 @@
 
 *Derived from Matt Pocock's `handoff` (MIT). `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Same handoff document as [`handoff`](../handoff/), but Claude (or a skill or subagent) can call it without you typing a command.

diff --git a/handoff/README.md b/handoff/README.md
@@ -2,6 +2,8 @@
 
 *By Matt Pocock (MIT); one sentence modified so the file saves under `skilleddocs/handoffs/`, one added for whether to commit it. `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto` (installed with it).
+
 ## What it does
 
 Turns this conversation into a handoff document. A fresh session can pick up the work from it, without the old context.

diff --git a/hooks/README.md b/hooks/README.md
@@ -1,8 +1,8 @@
 # hooks/ — optional per-repo hooks
 
-Not installed by a full `install-skills` run; copy what you want into a repo's `.claude/hooks/` and wire it in that repo's `.claude/settings.json`.
+Not installed by a full `install-skills` run; copy what you want into a repo's `.claude/hooks/` and wire it in that repo's `.claude/settings.json`. Each hook works on its own.
 
-- `install-skills --workflow <name>` with a workflow that uses a hook copies it to `~/.claude/hooks/` and prints the user-level `settings.json` snippet below; it never wires it in.
+- `install-skills --skill <hook>`, or `--workflow <name>` with a workflow that uses a hook, copies it to `~/.claude/hooks/` and prints the user-level `settings.json` snippet below; it never wires it in.
 - The agents' own `guard-git.py` lives in [`../agents/hooks/`](../agents/hooks/) and *is* installed, into `~/.claude/agents/hooks/`, or wired by the plugin.
 - None of these ship with the plugin either.
 

diff --git a/kanban/consult-plan/README.md b/kanban/consult-plan/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Needs: `next` (installed with it).
+
 ## What it does
 
 Grills a proposed change, deviation or new idea against the repo's existing plan (open issues, board, roadmap doc), then records the outcome where the repo already keeps decisions.

diff --git a/kanban/divide/README.md b/kanban/divide/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Needs: `next` (installed with it).
+
 ## What it does
 
 Splits an issue (or a described task) that's too big for one session into two or more session-sized issues (about the ~75K-token smart zone, one PR).

diff --git a/kanban/kanban-setup/README.md b/kanban/kanban-setup/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Needs: `next` (installed with it).
+
 ## What it does
 
 Creates a GitHub Projects (v2) board for a repo if it has none, then backfills issues from work already documented in the repo: planned work, already-done work (created and immediately closed, for history), or both.

diff --git a/kanban/next/README.md b/kanban/next/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Works on its own.
+
 ## What it does
 
 Shows the next 1–3 tasks to work on, pulled from the repo's GitHub kanban board, with a size and a suggested model for each.

diff --git a/kanban/session-handoff/README.md b/kanban/session-handoff/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Needs: `handoff-auto`, `kanban-setup`, `next` (installed with it).
+
 ## What it does
 
 Ends an implementation session tied to a GitHub issue: writes the handoff document (via `handoff-auto`), adds a `## Board status` section, and moves the issue's card to reflect reality.

diff --git a/kanban/update-progress/README.md b/kanban/update-progress/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you. Loop overview: [`kanban/README.md`](../README.md).*
 
+Needs: `next` (installed with it).
+
 ## What it does
 
 Takes a handoff document, **verifies** its claims (git log, tests, code review), then updates the repo's docs, the board and the issue to match what actually happened.

diff --git a/lanes/README.md b/lanes/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `consult-plan`, `divide`, `handoff-auto`, `kanban-setup`, `meta-orchestrator`, `next`, `pair`, `progress-report`, `session-handoff`, `update-progress`, `implementer`, `manager`, `planner`, `verifier` (installed with it).
+
 ## What it does
 
 Sets how many issues a [`meta-orchestrator`](../meta-orchestrator/) run works on at once. It predicts which files each queued issue will touch, groups issues that share files into the same **lane**, proposes a lane count with a cost line, and on your yes writes the lanes into the run's `scope.md`.

diff --git a/meta-orchestrator/README.md b/meta-orchestrator/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; `SETUP.md` (first-run interview + every option) and `ROTATION.md` (handoff / resume) are loaded only when needed. This file is for you.*
 
+Needs: `consult-plan`, `divide`, `handoff-auto`, `kanban-setup`, `lanes`, `next`, `pair`, `progress-report`, `session-handoff`, `update-progress`, `implementer`, `manager`, `planner`, `verifier` (installed with it).
+
 ## What it does
 
 Works through a repo's backlog unattended. Claude becomes the **orchestrator**: it never implements.

diff --git a/pair/README.md b/pair/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto`, `kanban-setup`, `next`, `session-handoff`, `implementer`, `manager` (installed with it).
+
 ## What it does
 
 Runs **one task** (a GitHub issue or free text) through a `manager` subagent in an isolated git worktree. The manager spawns and reviews an `implementer`, retrying up to 3 rounds. You stay in one interactive session; only your session pushes and opens the PR, at the end.

diff --git a/ponytail/README.md b/ponytail/README.md
@@ -2,6 +2,8 @@
 
 *By DietrichGebert (MIT), included verbatim from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail/blob/84740e3d344b69b4a133201fa519eb37a62a2b2a/skills/ponytail/SKILL.md) (v5.2.0). `SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Puts Claude in "lazy senior developer" mode for the whole session: it solves the task with the smallest change that fully works, and ends its reply with one or two lines saying what it skipped or did not check, plus any risk you must know.

diff --git a/pr-watch/README.md b/pr-watch/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto` (installed with it).
+
 ## What it does
 
 Watches your open pull requests (your own repo, or a fork against its upstream) until they merge.
@@ -36,7 +38,7 @@ Watches your open pull requests (your own repo, or a fork against its upstream)
    - Cites its thread URL.
 3. **Read CI** (`gh pr checks`); a fork PR stuck at `action_required` is reported as waiting on maintainer approval, not as failing.
 4. **Fix** the valid threads through [`pair`](../pair/) (one call per PR, every valid thread's path/line/body as the task), which reruns the tests.
-   - Where subagents can't be spawned, it fixes inline on the head branch with the same gates.
+   - Where subagents can't be spawned, or `pair` isn't installed, it fixes inline on the head branch with the same gates.
 5. **Gate.** Shows the diff summary and drafted replies, and asks before pushing or replying.
    - A force push needs its own fresh yes even if the push itself was already approved.
 6. **Push, then reply and resolve.**
@@ -139,4 +141,4 @@ each wait for their own yes:
 - `gh` authenticated with `repo` scope.
 - `origin` on GitHub (otherwise it stops and says so).
 - Write access where you expect to resolve threads.
-- `pair`'s agents installed for the fix step.
+- Optional: `pair` and its agents for the fix step (without them it fixes inline).
diff --git a/pr-watch/SKILL.md b/pr-watch/SKILL.md
@@ -53,7 +53,7 @@ Classify each unresolved thread, citing its URL:
 
 One `pair` call per PR on its existing head branch, every **valid** thread (path, line, body) as the task. Tell it the PR exists: no new PR, no push. disagree/question threads get replies, not diffs.
 
-Can't spawn subagents (so `pair` can't run)? Fix inline on the PR's head branch instead: same valid threads, run the repo's tests, commit; the §5 gates still apply.
+Can't spawn subagents, or `pair` isn't installed? Fix inline on the PR's head branch instead: same valid threads, run the repo's tests, commit; the §5 gates still apply.
 
 ## 5. Gate, then push and reply
 

diff --git a/progress-report/README.md b/progress-report/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto` (installed with it).
+
 ## What it does
 
 Turns a run's ledger into a short progress report (1–2 pages) covering **only what happened since the last report** — never overlapping.

diff --git a/remind/README.md b/remind/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Sets reminders tied to your Claude accounts or to a time. A due reminder shows once at your next prompt, and timed ones also pop up on your desktop at the exact time.

diff --git a/repo-scrub/README.md b/repo-scrub/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Works on its own.
+
 ## What it does
 
 Scans a GitHub repo's **full git history** for secrets and oversized files.

diff --git a/repo-showcase/README.md b/repo-showcase/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto` (installed with it).
+
 ## What it does
 
 Gets a repo's working tree ready to be seen.

diff --git a/score-loop/README.md b/score-loop/README.md
@@ -2,6 +2,8 @@
 
 *`SKILL.md` is the prompt Claude follows; this file is for you.*
 
+Needs: `handoff-auto`, `spend-gate` (installed with it).
+
 ## What it does
 
 Pushes one numeric score up (or down) unattended. Claude tries one idea per commit: