Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.
cd ~/.claude/skills
git clone https://github.com/mattpocock/skills.git skills mkdir -p ~/.claude/skills/writing-beats
curl -fsSL https://raw.githubusercontent.com/mattpocock/skills/HEAD/skills/in-progress/writing-beats/SKILL.md \
-o ~/.claude/skills/writing-beats/SKILL.md The user has passed (or will pass) a markdown file of raw material.
If the user did not say where to save the article, ask once and remember the path.
Then run a beat-by-beat journey:
A beat is one move in the journey. It does one thing — sets a scene, lands a point, asks a question, drops an aside, twists the angle. Then it stops, leaving the reader at a place where the next beat can pivot.
A beat is sized by what it needs:
If a “beat” needs five paragraphs and three subheadings, it’s not a beat — it’s two beats glued together. Split it.
Once a beat is picked, write that beat only to the article file. Do not write the next beat.
Pull material from the raw pile to populate the beat. You can paraphrase, split, recombine, or quote. The pile is a quarry.
The article ends when the journey is complete — not when the pile is empty. Most piles will have leftover fragments that don’t make it in. That is fine; that is the point of having more raw material than you need.
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback
Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions