writing-beats

Assembles raw material into articles one beat at a time with concept grounding.

2|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/IsKenKenYa/skills --skill writing-beats-iskenkenya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/IsKenKenYa/skills/tree/main/skills/in-progress/writing-beats
Command: npx skills add https://github.com/IsKenKenYa/skills --skill writing-beats-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes into a coherent article is hard because ideas must be introduced before they can be used. This Skill structures the writing process as a beat-by-beat journey where every concept is grounded before any later beat depends on it, so readers never hit an unexplained term. ## Core Features & Use Cases - Beat-by-beat drafting: Writes one beat (a sentence to a few paragraphs) at a time, appending to the article file and never writing ahead. - Concept grounding tracking: Maintains a running list of grounded concepts; candidate beats must only rely on already-grounded ideas and declare what new concepts they ground. - Choose-your-own-adventure flow: Offers 2-3 candidate next beats at each step so the user picks the direction, with previews of which paths each choice unlocks. - 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 iteratively build the article while preserving your edits between beats. ## Quick Start Use the writing-beats skill to turn my raw notes file into an article, building it one beat at a time and letting me choose each next beat.

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 proposes 2-3 candidate starting beats, you pick one, it writes only that beat, then offers next beats until the article reaches a natural end.

What is concept grounding in writing?

Grounding means every concept is either a prerequisite the audience already knows or is introduced by an earlier beat before any later beat uses it. The Skill tracks the grounded set so no beat ever relies on an unexplained idea.

Can I edit beats the Skill already wrote?

Yes. The Skill re-reads the article file from disk before every write and preserves your edits absolutely. If you substantially change a beat, it adapts what comes next, and you can ask it to rewrite any beat in place.

When should I not use a beat-by-beat writing approach?

Avoid it when you need a complete draft in one pass or when the material is already structured, since the method commits to one path through a fixed pile and intentionally leaves unused fragments behind.

How long is a single beat in an article?

A beat is sized by its move: one sentence if that is all it needs, a short paragraph with setup, or several paragraphs for a self-contained vignette. Anything needing five paragraphs and subheadings should be split into two beats.