Writing Shape

You have a pile of notes or a messy draft and you want it shaped into an actual article. This skill runs a conversational editing session that starts by drafting 2–3 candidate openings, forces you to pick one, then builds the piece paragraph by paragraph. It argues with you about format at each step: should this be prose or a list, does this deserve a callout, is this transition earning its place. The raw material file stays untouched. Everything gets written to a separate article document as you go, so you can edit between turns and watch the piece take shape. It's opinionated about structure and will push back if something doesn't land.

skills.sh installs: 530.7K
GitHub stars: 319.9K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mattpocock/skills --skill writing-shape --agent claude-code

Installs into .claude/skills of the current project.

Files

The user has passed (or will pass) a markdown file of raw material. Treat it as the input pile: anything from a tidy list of fragments to a wall of unstructured prose to a transcript. The format does not matter. Read it end-to-end before doing anything else.

Then run a shaping session that produces a separate article document. This is exploit: the exploring is done, the pile is fixed: commit to a structure and mine the pile to fill it. Do not edit the raw material file: it is read-only to this skill.

If the user did not say where to save the article, ask once and remember the path.