writing-shape

writing shape

mattpocock ↓ 147k
Claude Code
View source ↗

What it does

  • Prerequisite — grounded before the opening. The reader brings it. Fixed at the start.
  • Introduced — a block establishes it, and from then on it's grounded for the rest of the article.
  • "What does this paragraph do for the reader that the previous one didn't?"
  • "If I cut this, what breaks?"
  • "Is this prose, or should it be a list? Why prose?"
  • "This sentence is doing two jobs — split it or pick one."
  • "The opening promised X. We've drifted to Y. Either re-thread it or change the opening."

Requirements & configuration

  • Prerequisite — grounded before the opening. The reader brings it. Fixed at the start.
  • If the pile lacks something the article needs, name the gap explicitly: "We need an example here and the pile doesn't have one — give me one now or we cut this section."
  • Code block vs. inline code. Multi-line, runnable, or illustrative → block. Single token or identifier → inline.

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

writing shape

Source

Repository: https://github.com/mattpocock/skills

writing-shape FAQ

What does the writing-shape skill do?

Writing, exploit — shape raw material into an article, paragraph by paragraph. Prerequisite — grounded before the opening. The reader brings it. Fixed at the start. Introduced — a block establishes it, and from then on it's grounded for the rest of the article.

What does writing-shape require?

Prerequisite — grounded before the opening. The reader brings it. Fixed at the start. If the pile lacks something the article needs, name the gap explicitly: "We need an example here and the pile doesn't have one — give me one now or we cut this section." Code block vs. inline code. Multi-line, runnable, or illustrative → block. Single token or identifier → inline.

How do I install writing-shape?

Run: npx -y skills add https://github.com/mattpocock/skills --skill writing-shape --agent claude-code — the source lives at github.com/mattpocock/skills.

Maintain writing-shape?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

writing-shape on getagentictools
[![writing-shape on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-writing-shape.svg)](https://getagentictools.com/skills/mattpocock-skills-writing-shape?ref=badge)
npx agentictools info skills/mattpocock-skills-writing-shape

The second line is the CLI lookup for this page — handy in READMEs and docs.