writing-beats — Skills — getagentictools

What it does

Prerequisite — grounded before the first beat. The audience brings it. Fixed at the start.

Introduced — a beat establishes it, and from then on it's grounded for every later beat.

A single sentence if that's all the move is ("And then nothing happened for three weeks.").

A short paragraph if the move needs setup.

Multiple paragraphs if the beat is a self-contained vignette, argument, or example.

Append one beat at a time. Never write ahead.

Re-read the article file from disk before every write. Preserve user edits absolutely.

Requirements & configuration

Prerequisite — grounded before the first beat. The audience brings it. Fixed at the start.

So each beat does two jobs: it requires concepts that are already grounded, and it grounds new ones. Keep a running list of what's grounded so far, and update it each time a beat lands.

A beat is sized by what it needs:

A short paragraph if the move needs setup.

If a "beat" needs five paragraphs and three subheadings, it's not a beat — it's two beats glued together. Split it.

writing beats

Source

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

writing-beats FAQ

What does the writing-beats skill do?

Writing, exploit — assemble raw material into a journey of beats, grounding each term before a beat leans on it. Prerequisite — grounded before the first beat. The audience brings it. Fixed at the start. Introduced — a beat establishes it, and from then on it's grounded for every later beat.

What does writing-beats require?

Prerequisite — grounded before the first beat. The audience brings it. Fixed at the start. So each beat does two jobs: it requires concepts that are already grounded, and it grounds new ones. Keep a running list of what's grounded so far, and update it each time a beat lands. A beat is sized by what it needs: A short paragraph if the move needs setup. If a "beat" needs five paragraphs and three subheadings, it's not a beat — it's two beats glued together. Split it.

How do I install writing-beats?

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

Maintain writing-beats?

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-beats on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-writing-beats.svg)](https://getagentictools.com/skills/mattpocock-skills-writing-beats?ref=badge)

npx agentictools info skills/mattpocock-skills-writing-beats

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