diff --git a/.agents/install-block.md b/.agents/install-block.md
index 26f511e..8971bde 100644
--- a/.agents/install-block.md
+++ b/.agents/install-block.md
@@ -36,7 +36,7 @@ Pick the skills you want, and which coding agents to install them on. **The inst
-…and the single-skill form on a `docs/` page, where the page already names one skill:
+…and the single-skill form wherever one skill is named on its own. Note that **`docs/` pages are not a consumer of this block**: ai-hero renders the install widget above the body, so a page that writes the commands out duplicates it. See [writing-docs.md](./writing-docs.md).
@@ -50,7 +50,7 @@ npx skills@latest update
-`skills@latest` is the pinned spelling in all three. The Quickstart template in [writing-docs.md](./writing-docs.md), and the 24 pages under `docs/`, still carry the older bare `npx skills …`; the docs pass brings them into line.
+`skills@latest` is the pinned spelling in all three. The pages under `docs/` used to carry their own copy of these commands; those blocks are now deleted rather than corrected, because the site renders the install commands itself.
## The two routes are exclusive
diff --git a/.agents/writing-docs.md b/.agents/writing-docs.md
index 6b81791..fd0a8e1 100644
--- a/.agents/writing-docs.md
+++ b/.agents/writing-docs.md
@@ -12,22 +12,12 @@ There is no H1 — the published page takes its title from the slug.
## Page structure
-Fill the template below. The **fixed frame** (Quickstart block, source link, `## What it does`, `## When to reach for it`, `## Where it fits`) appears on every page. The **adaptable middle** — `## Prerequisites` and the free-form substance sections — carries only what this particular skill earns; delete the rest.
+Fill the template below. The **fixed frame** (source link, `## What it does`, `## When to reach for it`, `## Where it fits`) appears on every page. The **adaptable middle** — `## Prerequisites` and the free-form substance sections — carries only what this particular skill earns; delete the rest.
-Install commands are not written per page. Copy them verbatim from [the canonical install block](./install-block.md) — it is the single source for how anyone installs these skills, and a page that words it differently is a page that tells a second story. The Quickstart block in the template below is the older wording and does not yet match; the docs pass replaces it from the canonical block.
+**A page carries no install commands.** The ai-hero page template renders the install widget itself — a copy button, the single-skill command, the whole-set command, and the update line — above the body. A page that also writes them out shows the reader the same command twice, and the two copies drift: the hand-written pair on every page went stale against the widget beside it. Install wording is a property of the site, not of the page. If it needs changing, change it in ai-hero; the canonical wording lives in [the install block](./install-block.md).
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=
-```
-
-```bash
-npx skills update
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills//)
## What it does
@@ -74,7 +64,7 @@ Always present. Situate the skill in the system in a sentence or two:
## Done when
- The page exists at `docs//.md`, and no stale page survives a rename or bucket move.
-- The Quickstart block and source link name the correct bucket and skill; the update line names the skill.
+- The source link names the correct bucket and skill, and the page writes no install command of its own.
- `## What it does` states the defining constraint, as plain prose rather than a labelled aside.
- `## When to reach for it` states invocation mode and the trigger boundary.
- `## Where it fits` names the role and links to `ask-matt`.
diff --git a/.changeset/docs-drop-quickstart.md b/.changeset/docs-drop-quickstart.md
new file mode 100644
index 0000000..cbb1404
--- /dev/null
+++ b/.changeset/docs-drop-quickstart.md
@@ -0,0 +1,11 @@
+---
+"mattpocock-skills": patch
+---
+
+Drop the hand-written Quickstart block from all 25 docs pages.
+
+aihero.dev already renders an install widget above every skill page — a copy button, the single-skill command, the whole-set command, and the update line. Each page then wrote the same two commands out again immediately below it. The reader saw the install command twice.
+
+The two copies had also drifted apart. The widget renders the current `npx skills@latest …` wording; the hand-written blocks still carried the older bare `npx skills …`, so most pages showed the correct command and a stale one, one after the other.
+
+Deleting the block removes those stale copies and leaves the site's own. `.agents/writing-docs.md` now states the rule directly — install wording is a property of the site, not of the page — and its template no longer carries a Quickstart to copy.
diff --git a/.changeset/docs-grill-me-pass.md b/.changeset/docs-grill-me-pass.md
new file mode 100644
index 0000000..57def85
--- /dev/null
+++ b/.changeset/docs-grill-me-pass.md
@@ -0,0 +1,17 @@
+---
+"mattpocock-skills": patch
+---
+
+Rewrite the `grill-me` docs page around what people actually get wrong.
+
+The old page explained the mechanism — rounds, the frontier, the decision tree — and stopped there. Every recurring question from the last few months went unanswered on it: which of the three grilling skills to reach for, how many questions is normal, what to do when a question can't be answered by talking, and whether to start a fresh session before writing the spec.
+
+The rewrite keeps the mechanism short and spends the page on the judgement calls instead:
+
+- **Sibling routing** is now a three-way list keyed on what you have in front of you — no codebase, a codebase, or too big for one session — rather than a paragraph.
+- **"It's a conversation, not an interview"** names passivity as the main failure mode. A session where you answer "agreed" forty times produces a plan you didn't write and can't defend.
+- **"Grillable and ungrillable"** gives readers the move for a question that talking cannot settle: stop, prototype, come back. This is where long sessions come from.
+- **A "Common questions" section** answers the six highest-volume ones directly, including how to restore one-question-at-a-time and why you should not clear context before `to-spec`.
+- **"It's working if"** added, led by the sharpest signal: if you never disagreed, you didn't need the session.
+
+Also drops the "plan mode" ambiguity by saying plainly to leave it off.
diff --git a/docs/engineering/ask-matt.md b/docs/engineering/ask-matt.md
index 6fa0c66..3974d06 100644
--- a/docs/engineering/ask-matt.md
+++ b/docs/engineering/ask-matt.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=ask-matt
-```
-
-```bash
-npx skills update ask-matt
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt)
## What it does
diff --git a/docs/engineering/code-review.md b/docs/engineering/code-review.md
index ac48f2b..28e463a 100644
--- a/docs/engineering/code-review.md
+++ b/docs/engineering/code-review.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=code-review
-```
-
-```bash
-npx skills update code-review
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/code-review)
## What it does
diff --git a/docs/engineering/codebase-design.md b/docs/engineering/codebase-design.md
index 2240e74..1405d32 100644
--- a/docs/engineering/codebase-design.md
+++ b/docs/engineering/codebase-design.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=codebase-design
-```
-
-```bash
-npx skills update codebase-design
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/codebase-design)
## What it does
diff --git a/docs/engineering/diagnosing-bugs.md b/docs/engineering/diagnosing-bugs.md
index a4f5ca4..b8f6fd8 100644
--- a/docs/engineering/diagnosing-bugs.md
+++ b/docs/engineering/diagnosing-bugs.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=diagnosing-bugs
-```
-
-```bash
-npx skills update diagnosing-bugs
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/diagnosing-bugs)
## What it does
diff --git a/docs/engineering/domain-modeling.md b/docs/engineering/domain-modeling.md
index 273cfde..8a27e03 100644
--- a/docs/engineering/domain-modeling.md
+++ b/docs/engineering/domain-modeling.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=domain-modeling
-```
-
-```bash
-npx skills update domain-modeling
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/domain-modeling)
## What it does
diff --git a/docs/engineering/grill-with-docs.md b/docs/engineering/grill-with-docs.md
index b7cfd75..e2cb815 100644
--- a/docs/engineering/grill-with-docs.md
+++ b/docs/engineering/grill-with-docs.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=grill-with-docs
-```
-
-```bash
-npx skills update grill-with-docs
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs)
## What it does
diff --git a/docs/engineering/implement.md b/docs/engineering/implement.md
index e079af8..2862785 100644
--- a/docs/engineering/implement.md
+++ b/docs/engineering/implement.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=implement
-```
-
-```bash
-npx skills update implement
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/implement)
## What it does
diff --git a/docs/engineering/improve-codebase-architecture.md b/docs/engineering/improve-codebase-architecture.md
index f8a9150..7e97d7d 100644
--- a/docs/engineering/improve-codebase-architecture.md
+++ b/docs/engineering/improve-codebase-architecture.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=improve-codebase-architecture
-```
-
-```bash
-npx skills update improve-codebase-architecture
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/improve-codebase-architecture)
## What it does
diff --git a/docs/engineering/prototype.md b/docs/engineering/prototype.md
index e8cdf6a..dbb3801 100644
--- a/docs/engineering/prototype.md
+++ b/docs/engineering/prototype.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=prototype
-```
-
-```bash
-npx skills update prototype
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/prototype)
## What it does
diff --git a/docs/engineering/research.md b/docs/engineering/research.md
index 5254b41..908bacf 100644
--- a/docs/engineering/research.md
+++ b/docs/engineering/research.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=research
-```
-
-```bash
-npx skills update research
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/research)
## What it does
diff --git a/docs/engineering/resolving-merge-conflicts.md b/docs/engineering/resolving-merge-conflicts.md
index 463dea8..c518fd8 100644
--- a/docs/engineering/resolving-merge-conflicts.md
+++ b/docs/engineering/resolving-merge-conflicts.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=resolving-merge-conflicts
-```
-
-```bash
-npx skills update resolving-merge-conflicts
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/resolving-merge-conflicts)
## What it does
diff --git a/docs/engineering/setup-matt-pocock-skills.md b/docs/engineering/setup-matt-pocock-skills.md
index 003b8b6..d026673 100644
--- a/docs/engineering/setup-matt-pocock-skills.md
+++ b/docs/engineering/setup-matt-pocock-skills.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=setup-matt-pocock-skills
-```
-
-```bash
-npx skills update setup-matt-pocock-skills
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/setup-matt-pocock-skills)
## What it does
diff --git a/docs/engineering/tdd.md b/docs/engineering/tdd.md
index 46b636e..d90a0ef 100644
--- a/docs/engineering/tdd.md
+++ b/docs/engineering/tdd.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=tdd
-```
-
-```bash
-npx skills update tdd
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/tdd)
## What it does
diff --git a/docs/engineering/to-spec.md b/docs/engineering/to-spec.md
index 1f9b23f..7758c89 100644
--- a/docs/engineering/to-spec.md
+++ b/docs/engineering/to-spec.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=to-spec
-```
-
-```bash
-npx skills update to-spec
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/to-spec)
## What it does
diff --git a/docs/engineering/to-tickets.md b/docs/engineering/to-tickets.md
index 1e4dca7..9c21502 100644
--- a/docs/engineering/to-tickets.md
+++ b/docs/engineering/to-tickets.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=to-tickets
-```
-
-```bash
-npx skills update to-tickets
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/to-tickets)
## What it does
diff --git a/docs/engineering/triage.md b/docs/engineering/triage.md
index 5ef6dfa..18e9e9c 100644
--- a/docs/engineering/triage.md
+++ b/docs/engineering/triage.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=triage
-```
-
-```bash
-npx skills update triage
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/triage)
## What it does
diff --git a/docs/engineering/wayfinder.md b/docs/engineering/wayfinder.md
index 5ececb1..b7137c2 100644
--- a/docs/engineering/wayfinder.md
+++ b/docs/engineering/wayfinder.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=wayfinder
-```
-
-```bash
-npx skills update wayfinder
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/wayfinder)
## What it does
diff --git a/docs/engineering/wizard.md b/docs/engineering/wizard.md
index 24a33e4..c1f9413 100644
--- a/docs/engineering/wizard.md
+++ b/docs/engineering/wizard.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=wizard
-```
-
-```bash
-npx skills update wizard
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/engineering/wizard)
## What it does
diff --git a/docs/productivity/grill-me.md b/docs/productivity/grill-me.md
index abe214c..a209133 100644
--- a/docs/productivity/grill-me.md
+++ b/docs/productivity/grill-me.md
@@ -1,33 +1,78 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=grill-me
-```
-
-```bash
-npx skills update grill-me
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me)
## What it does
-`grill-me` runs a relentless interview about a plan or design, walking every branch of the decision tree until you and the agent reach a **shared understanding**.
+`grill-me` takes a **loose idea** and interviews you until it has real decisions in it. You do not need a worked-out plan to start — producing one is what the session is for. It asks in **rounds**: each round is the whole **frontier** — every question whose prerequisites you have already settled — so you are never asked something that hinges on an answer it hasn't heard yet.
-It asks in **rounds** and waits. A round is the whole **frontier** — every decision whose prerequisites are already settled — put to you as one numbered list, so you're never asked something that hinges on an answer the agent hasn't heard yet. Where a question can be answered by reading the codebase, it goes and reads rather than asking. Each question comes with the agent's own recommended answer, so you are reacting to a proposal, not staring at a blank prompt.
+It is **stateless**. It writes no files and leaves no workspace behind. The only thing it leaves is a sharper version of the idea, in your own head.
## When to reach for it
-You invoke this by typing `/grill-me` — the agent won't reach for it on its own.
+You invoke this by typing `/grill-me` — the agent won't reach for it on its own. Start it in a **fresh conversation**, not on top of a plan you already had an agent write.
-Reach for it before you build, when a plan feels roughly right but you can sense unresolved decisions hiding in it — the moment you want the soft spots found and forced into the open. If you want that same interrogation to also leave a paper trail of ADRs and a glossary behind, use [grill-with-docs](https://aihero.dev/skills-grill-with-docs) instead. And if the effort is too big to hold in one session and the route to the goal is still foggy — a greenfield project, a huge feature build — start further upstream with [wayfinder](https://aihero.dev/skills-wayfinder), which charts it as a map of decisions first and then merges back into this flow.
+Reach for it as soon as you have an idea worth taking seriously — a feature, a product direction, a business call, a piece of writing — and long before you have worked out what it involves. Vagueness is not a reason to wait; it is the thing the session eats. If you can already specify the thing precisely, you don't need to grill it.
-## The decision tree
+Which of the three grilling skills you want depends on what is in front of you:
-The session walks the plan as a tree of decisions, settling a parent decision before the choices that hang off it. Your answers reshape the tree and push the frontier outward, so the next round asks whatever they unblocked. The point is not to reach agreement quickly; it is to make every implicit call explicit, so nothing important is left silently assumed. You come out the other side with a plan whose branches have all been visited.
+- **Anything, anywhere** — `grill-me`. It needs no repo and writes no files, and the subject doesn't have to be code.
+- **A codebase to align against** — [grill-with-docs](https://aihero.dev/skills-grill-with-docs). The same interview, but stateful: it reads your code and keeps what it learns in `CONTEXT.md` and ADRs.
+- **Too big for one session** — [wayfinder](https://aihero.dev/skills-wayfinder). It charts the effort as a map and runs grilling sessions inside it.
-`grill-me` is **stateless**: it writes nothing and leaves no workspace behind. It runs anywhere, and the only artifact is the sharpened understanding in the conversation itself. That is the deliberate contrast with [grill-with-docs](https://aihero.dev/skills-grill-with-docs), which captures the same interview as durable ADRs and a glossary.
+Leave plan mode off. Plan mode primes the agent to rush toward producing a plan, which is the opposite of staying in inquiry.
+
+## It's a conversation, not an interview
+
+The skill asks the questions, but **you** own the scope. That is the part people miss, and it separates a session that turns an idea into decisions from one that produces confident nonsense.
+
+The failure mode is **passivity** — answering "agreed, agreed, agreed" for forty questions and coming out with a plan the agent wrote and you nodded at. It feels productive because it was long. Nothing was actually decided, and the result carries a certainty it hasn't earned.
+
+Being active means steering. Push back on a question pitched beneath the fidelity you need. Say when the scope is drifting. Answer "I don't know" and mean it. This skill is built to aid an engineer, not to replace one: what comes out tracks the quality of your answers, not the number of questions asked.
+
+The opposite error is real but rarer — staying in the interview so long you never reach code.
+
+## Grillable and ungrillable
+
+Some questions can be answered by talking. Others can't, and no amount of grilling will get you there.
+
+"One long form or three pages?" and "how should this interaction feel?" are **ungrillable** — they need something to react to. When you hit one, stop grilling. Build the throwaway version with [prototype](https://aihero.dev/skills-prototype), look at it, then come back and answer in one line.
+
+Talking your way through an ungrillable question is where sessions balloon. The agent keeps rephrasing, you keep guessing, and the scope grows to fill the uncertainty.
+
+## It's working if
+
+- You disagree with something. A session with no pushback from you is a session you didn't need.
+- Questions arrive in a few rounds rather than one long drip, and later rounds clearly build on what you said earlier.
+- You end up somewhere you didn't expect, because a question surfaced a decision you had been making implicitly.
+- At the end you could defend each choice to someone who wasn't there.
+
+## Common questions
+
+**How many questions should I expect, and how do I know when it ends?**
+Count rounds, not questions. Forty-six questions across four rounds is an ordinary session. It ends when the frontier is empty — every branch visited, nothing left silently assumed.
+
+**It asked me two hundred questions. What went wrong?**
+Usually the scope was too large. Ask the agent to break the work into smaller pieces first, then grill each one. Very long sessions also drift into the **dumb zone**, where the context window is full enough that the questions get worse.
+
+**Can I go back to one question at a time?**
+Yes. Add this to your global `CLAUDE.md`:
+
+```
+When grilling, ask one question at a time.
+```
+
+**What if I genuinely don't know the answer?**
+Say so. "I don't know" is a real answer, and a question you can't answer is usually a sign to prototype rather than to guess.
+
+**Do I start a fresh session before writing the spec?**
+No. The value of the session is the context you just built. Hand the same conversation straight to [to-spec](https://aihero.dev/skills-to-spec).
+
+**Does the model matter?**
+More than for most skills. Grilling leans on the model's own sense of how systems break, so give it your best one. Implementation mostly follows context and tolerates a cheaper model.
## Where it fits
-`grill-me` is a reach-for-it-anytime standalone — the pre-build stress test you run whenever a plan needs hardening. It is the stateless, user-invoked front door to the [grilling](https://aihero.dev/skills-grilling) primitive; its closest neighbour is [grill-with-docs](https://aihero.dev/skills-grill-with-docs), the stateful sibling that runs the same interview but additionally records the decisions as ADRs and a glossary. If the outcome is a spec you want written down, hand off to [to-spec](https://aihero.dev/skills-to-spec), which synthesises the settled understanding into a spec without re-interviewing you. When you're unsure which flow fits, [ask-matt](https://aihero.dev/skills-ask-matt) routes you.
+`grill-me` is a **standalone you can run anywhere, on anything**. Being stateless is what makes it portable: no repo, no workspace, no setup, and no assumption that the idea is even about software. People point it at business decisions, at writing, at what to do next — anything that won't sit still in their head.
+
+That portability is the whole difference from [grill-with-docs](https://aihero.dev/skills-grill-with-docs), which runs the same interview but reads a codebase to align against and records what it learns as `CONTEXT.md` and ADRs. Both sit on the [grilling](https://aihero.dev/skills-grilling) primitive; `grill-me` is the user-invoked front door that carries nothing with it.
+
+If what you grilled does turn out to be software, you can hand the same conversation to [to-spec](https://aihero.dev/skills-to-spec) and carry on into the build flow — an option, not the point of the skill. When you're unsure which flow fits, [ask-matt](https://aihero.dev/skills-ask-matt) routes you.
diff --git a/docs/productivity/grilling.md b/docs/productivity/grilling.md
index efb2d15..d7bd5e2 100644
--- a/docs/productivity/grilling.md
+++ b/docs/productivity/grilling.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=grilling
-```
-
-```bash
-npx skills update grilling
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/grilling)
## What it does
diff --git a/docs/productivity/handoff.md b/docs/productivity/handoff.md
index 25901a0..3e38066 100644
--- a/docs/productivity/handoff.md
+++ b/docs/productivity/handoff.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=handoff
-```
-
-```bash
-npx skills update handoff
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff)
## What it does
diff --git a/docs/productivity/teach.md b/docs/productivity/teach.md
index 9fd2b96..dffccde 100644
--- a/docs/productivity/teach.md
+++ b/docs/productivity/teach.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=teach
-```
-
-```bash
-npx skills update teach
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/teach)
## What it does
diff --git a/docs/productivity/to-questionnaire.md b/docs/productivity/to-questionnaire.md
index 2bd8def..de89c61 100644
--- a/docs/productivity/to-questionnaire.md
+++ b/docs/productivity/to-questionnaire.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=to-questionnaire
-```
-
-```bash
-npx skills update to-questionnaire
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/to-questionnaire)
## What it does
diff --git a/docs/productivity/wait-what.md b/docs/productivity/wait-what.md
index 9dfb863..22e9cff 100644
--- a/docs/productivity/wait-what.md
+++ b/docs/productivity/wait-what.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills@latest add mattpocock/skills --skill=wait-what
-```
-
-```bash
-npx skills@latest update wait-what
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/wait-what)
## What it does
diff --git a/docs/productivity/writing-for-agents.md b/docs/productivity/writing-for-agents.md
index b338109..dda4208 100644
--- a/docs/productivity/writing-for-agents.md
+++ b/docs/productivity/writing-for-agents.md
@@ -1,13 +1,3 @@
-Quickstart:
-
-```bash
-npx skills add mattpocock/skills --skill=writing-for-agents
-```
-
-```bash
-npx skills update writing-for-agents
-```
-
[Source](https://github.com/mattpocock/skills/tree/main/skills/productivity/writing-for-agents)
## What it does