writing-beats

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

2|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/NAMEWTA/learning-open-code --skill writing-beats-namewta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/NAMEWTA/learning-open-code/tree/main/translator/open-ai-skills/matt-pocock-skills/skills/in-progress/writing-beats
Command: npx skills add https://github.com/NAMEWTA/learning-open-code --skill writing-beats-namewta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes and research into a coherent article is hard because writers often introduce concepts before readers are ready for them. This Skill structures the drafting process as a guided, beat-by-beat journey where every concept is grounded before it is used. ## Core Features & Use Cases - Beat-by-Beat Drafting: Writes one beat at a time, offering 2-3 candidate next beats at each step so the user chooses the article's direction. - Concept Grounding Tracking: Maintains a running list of grounded concepts, ensuring no beat depends on ideas the reader has not yet encountered. - Prerequisite Negotiation: Establishes upfront what readers already know, balancing accessibility against excessive in-article definitions. - Use Case: You have a markdown file of raw research notes for a technical blog post. The Skill proposes candidate opening beats, writes your choice to the article file, then iteratively offers next beats until the article reaches a natural ending. ## Quick Start Use the writing-beats skill to turn my raw notes 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 with AI?

Provide a markdown file of raw material and the skill runs a beat-by-beat journey: it proposes 2-3 candidate beats at each step, writes your chosen beat to the article file, and repeats until the article reaches a natural ending.

What is concept grounding in article writing?

Grounding means every concept must be established before any beat relies on it, either as a reader prerequisite or introduced by an earlier beat. The skill maintains a running list of grounded concepts and only offers beats reachable from that set.

Can I edit beats the AI has already written?

Yes. The skill re-reads the article file from disk before each write and preserves your edits. If you substantially change a beat, subsequent beat suggestions adapt to your revised direction.

Does the writing process use all of my raw material?

No. The article ends when the journey is complete, not when the material pile is exhausted. Leftover fragments are expected, since the raw material acts as a quarry rather than a checklist.

When is beat-by-beat writing not the right approach?

It is less suitable when you need a complete draft in one pass or when the structure is already fixed, such as filling a rigid template. The interactive loop trades speed for control over narrative direction.