Skip to content
SkillModel-led1,050 tokens in use

Writing Beats

Assemble a pile of raw notes into an article one beat at a time, choosing each next beat from options while every concept is grounded first.

328,791 stars on the repository MIT Licensemattpocock/skills · skills/in-progress/writing-beats
claude plugin install mattpocock-skills@claude-plugins-official
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Writing Beats costs

27tokens idle
1,050tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Fair
  • Frontmatter8/15
  • Structure19/25
  • Examples3/15
  • Output5/15
  • Size15/15
  • Resources0/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community56
  • Maturity32
  • Momentum40

Writing Beats is the second half of a two-step writing workflow. You hand it a Markdown file of raw material, and it runs a choose-your-own-adventure journey: it offers two or three candidate beats, you pick one, and it appends only that beat to the article file.

Before the first beat it settles what the audience already knows. Every later beat may lean only on concepts the reader already holds or met in an earlier beat.

What You Get

  • An article file that grows one beat at a time
  • A running list of grounded concepts
  • Two or three candidate beats at every turn with a preview of what each unlocks
  • Edits in place when you ask to rewrite or revisit a beat

Common Use Cases

  • Turning a fragment pile into a blog post
  • Writing a technical explainer where each term must be defined before use
  • Reworking a draft by asking for a different beat three
  • Building a narrative essay where the order of reveals matters

What Makes It Unique

Most writing skills draft a whole piece in one pass. This one writes a single beat, stops, re-reads the file from disk to keep your edits, and only then offers the next options. The grounding rule is the core idea: a beat that needs an ungrounded concept is unreachable, so the path always stays readable for the audience.

Under The Hood

The skill is a single Markdown file with an agent metadata file for Codex. It reads your raw material and the article file, and it writes only to the article path you give it. It runs no scripts and reaches no network service. It is user-invoked only.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers