writing-beats

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

2|Updated May 12, 2026
One-click install
npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill writing-beats-tajo9128
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/tajo9128/BioDockify-Pharma-AI/tree/main/.agents/skills/writing-beats
Command: npx skills add https://github.com/tajo9128/BioDockify-Pharma-AI --skill writing-beats-tajo9128

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw research notes into a coherent article is hard because writers must decide what to say first and ensure every concept is explained before it is used. This Skill structures that process as an interactive, beat-by-beat journey where each concept is grounded before any later beat relies on it. ## Core Features & Use Cases - Grounding Tracking: Maintains a running set of grounded concepts, distinguishing prerequisites the audience already knows from concepts introduced by earlier beats. - Choose-Your-Own-Adventure Flow: Offers 2-3 candidate next 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 file 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 notes from a research project. The Skill helps you pick an opening beat, then iteratively builds the article one beat at a time until the journey reaches a natural end. ## Quick Start Use the writing-beats skill to turn my raw notes file notes.md into an article, saving the output to article.md.

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 target article path. The skill proposes candidate starting beats, writes only the beat you pick, then iteratively offers next beats until the article reaches a natural end.

What is a beat in 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.

What does grounding a concept mean in this workflow?

A concept is grounded when the audience either knew it as a prerequisite or an earlier beat introduced it. A beat may only use concepts that are already grounded, and each new beat can ground additional concepts for later use.

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 beat, and only that beat is changed.

Does the article have to use all the raw material?

No. The article ends when the journey is complete, not when the pile is empty. Leftover fragments that do not fit the chosen path are expected and intentionally left out.