diff --git a/.changeset/wait-what.md b/.changeset/wait-what.md new file mode 100644 index 0000000..da37751 --- /dev/null +++ b/.changeset/wait-what.md @@ -0,0 +1,9 @@ +--- +"mattpocock-skills": minor +--- + +Add **`wait-what`** to `in-progress/` — a fire extinguisher for model verbosity. Fire it the moment a message doesn't land, and the agent re-pitches *that message*: a little context, ASD-STE100 Simplified Technical English, and the ubiquitous language from your `CONTEXT.md`. User-invoked, three lines long. + +The mechanism is the name. Concision skills fail by growing — a 400-line skill still leaves the model verbose — so this one is a single precise leading word and nothing else. It also reuses the leading words already in your global `CLAUDE.md`, so the skill, `CLAUDE.md` and every `CONTEXT.md` reach for the same tokens. + +It's the extinguisher, not the sprinkler. The cure for jargon is a shared language built upfront with `/grill-with-docs`; this is the in-the-moment corrective for when you don't have one yet. diff --git a/skills/in-progress/README.md b/skills/in-progress/README.md index 63556de..12270c2 100644 --- a/skills/in-progress/README.md +++ b/skills/in-progress/README.md @@ -7,4 +7,5 @@ Skills that are still being developed. They're not ready to ship — expect roug - **[writing-fragments](./writing-fragments/SKILL.md)** — Grilling session that mines you for fragments — heterogeneous nuggets of writing — and appends them to a single document as raw material for a future article. - **[writing-shape](./writing-shape/SKILL.md)** — Take a markdown file of raw material and shape it into an article paragraph by paragraph, arguing format choices at each step. - **[claude-handoff](./claude-handoff/SKILL.md)** — Hand the current conversation off to a fresh background agent that picks up the work immediately, seeded with a handoff summary via `claude --bg`. User-invoked. +- **[wait-what](./wait-what/SKILL.md)** — Fire this when the agent's last message did not land. It re-pitches that message with the context you're missing, in plain English, using your `CONTEXT.md` vocabulary. User-invoked. - **[setup-ts-deep-modules](./setup-ts-deep-modules/SKILL.md)** — Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files, tests exercising it through those. User-invoked. diff --git a/skills/in-progress/wait-what/SKILL.md b/skills/in-progress/wait-what/SKILL.md new file mode 100644 index 0000000..318c4be --- /dev/null +++ b/skills/in-progress/wait-what/SKILL.md @@ -0,0 +1,7 @@ +--- +name: wait-what +description: Stop. That last message did not land — re-pitch it. +disable-model-invocation: true +--- + +Wait — I don't understand where you've got to here. Re-pitch that last message: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md`. diff --git a/skills/in-progress/wait-what/agents/openai.yaml b/skills/in-progress/wait-what/agents/openai.yaml new file mode 100644 index 0000000..03490ca --- /dev/null +++ b/skills/in-progress/wait-what/agents/openai.yaml @@ -0,0 +1,5 @@ +interface: + display_name: "Wait What" + short_description: "Re-pitch that last message — simpler, with the context I'm missing" +policy: + allow_implicit_invocation: false