writing-beats

Assembles raw markdown material into articles through an interactive beat-by-beat writing workflow.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill writing-beats-fatih0234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/Fatih0234/mattpocock-skills-pi/tree/main/skills/in-progress/writing-beats
Command: npx skills add https://github.com/Fatih0234/mattpocock-skills-pi --skill writing-beats-fatih0234

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes and research into a coherent article is hard: writers struggle to choose an entry point, sequence ideas so each concept is introduced before it is used, and avoid dumping everything at once. This Skill structures that process as a guided, beat-by-beat journey. ## Core Features & Use Cases - Concept Grounding Tracking: Maintains a running set of grounded concepts so every beat only leans on ideas the reader already knows, either as prerequisites or introduced earlier. - Choose-Your-Own-Adventure Flow: Offers 2-3 candidate beats at each step, showing what each one grounds and which paths it unlocks, then writes only the chosen beat to the article file. - Edit-Safe Iteration: Re-reads the article from disk before every write, preserves user edits, and supports rewriting or replacing any previous beat on request. - Use Case: You have a markdown file of raw research notes for a technical blog post. The Skill helps you settle audience prerequisites, pick a starting beat, and grow the article one beat at a time until it reaches a natural end. ## Quick Start Ask the assistant to use the writing-beats skill to turn your raw notes markdown file into an article, one beat at a time.

Frequently Asked Questions about writing-beats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn raw notes into a structured article?▼

Provide a markdown file of raw material and the Skill runs a beat-by-beat journey: it settles audience prerequisites, offers candidate starting beats, and appends one chosen beat at a time until the article reaches a natural end.

What is a beat in article writing?▼

A beat is one move in the article's journey, such as setting a scene, landing a point, or asking a question. It can be a single sentence or several paragraphs, but anything larger should be split into multiple beats.

How does concept grounding work when sequencing an article?▼

Every concept must be grounded before a beat can use it, either as a prerequisite the audience brings or as an idea introduced by an earlier beat. The Skill keeps a running grounded list and only offers next beats reachable from it.

Can I edit or rewrite a beat after it is written?▼

Yes. The Skill re-reads the article file from disk before every write and preserves your edits. You can ask to rewrite a beat or go back and try a different one, and it edits in place without touching the rest.

When should I not use a beat-by-beat writing workflow?▼

Avoid it when you need a complete draft in one pass or when the material is already fully structured. The workflow is interactive and incremental, so it suits exploratory writing rather than bulk generation.