writing-beats

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

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill writing-beats-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/j172/bid/tree/main/agent/skills/writing-beats
Command: npx skills add https://github.com/j172/bid --skill writing-beats-j172

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 audience already knows or that earlier beats introduced. - Choose-your-own-adventure drafting: 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-aware iteration: Re-reads the article from disk before every write, preserves user edits, and supports rewriting or replacing earlier beats on request. - Use Case: You have a markdown file of raw research notes for a technical blog post. The Skill helps you settle 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 turn your raw notes markdown file into an article using the writing-beats workflow, and tell it where to save the article file.

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 a save path for the article. The Skill establishes audience prerequisites, proposes 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: a sentence, a short paragraph, or a self-contained vignette that does a single thing and stops. If a beat needs five paragraphs and subheadings, it should be split into multiple beats.

What does grounding a concept mean in writing?

A concept is grounded when the audience either knew it walking in as a prerequisite or an earlier beat introduced it. Every beat may only use grounded concepts, and each beat can ground new concepts that unlock later beats.

Can I rewrite an earlier beat without losing the rest of the article?

Yes. Ask to rewrite a specific beat or try a different one, and only that beat is edited in place while the rest of the article is left alone. The Skill re-reads the file from disk before every write to preserve your edits.

When should a concept be a prerequisite versus introduced in the article?

Demanding too many prerequisites shuts out readers who lack them, while grounding everything inside the piece buries early beats in definitions. Settle the balance with the user at the start and revisit it when a desired beat requires an ungrounded concept.