# Writing Beats

> Build article beat by beat from raw material with user-chosen pivots.

- Skill: `redpanda-data/writing-beats` (Agent Skill)
- Install (CLI): `npx skillmds@latest add redpanda-data/writing-beats`
- Raw SKILL.md: https://api.skillmd.com/api/skills/redpanda-data/writing-beats/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: redpanda-data (https://skillmd.com/u/redpanda-data)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/redpanda-data/writing-beats

---


# Writing Beats

Input: markdown raw material. If output path missing, ask once.

## Loop

1. Offer 2-3 candidate starting beats from raw material. User picks.
2. Write only that beat to article file.
3. Re-read article from disk.
4. Offer 2-3 next beats.
5. Repeat until natural end.

## Beat

One move in journey: scene, point, question, aside, twist. Size as needed. If it needs many sections, split.

## Rules

- Append one beat at time. Never write ahead.
- Preserve user edits: re-read before every write.
- Leftover raw material OK.
- If user says rewrite/go back/cut, edit specific beat, leave rest.