# Writing Shape

> Shape raw markdown material into an article through conversational drafting.

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

---


# Writing Shape

Input pile is read-only. Output article is separate. If output path missing, ask once.

## Loop

1. Read pile fully.
2. Draft 2-3 candidate openings with different thesis/angle. User picks or hybridizes.
3. Grow paragraph/block by paragraph/block. Ask what reader needs next.
4. Argue format: prose, list, callout, table, quote, code block.
5. Append agreed block immediately. Re-read article before every write.
6. Continue until user says done.

## Pushback

Ask: what does this do for reader? If cut, what breaks? Opening promised X; did we drift? Split two-job sentences.

Mine pile as quarry, not script. If missing example/evidence, name gap and ask or cut.