writing-beats

Assembles raw material into an article one user-selected narrative beat at a time.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/santoshkal/chezmoi --skill writing-beats-santoshkal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/santoshkal/chezmoi/tree/main/private_dot_config/opencode/skills/writing-beats
Command: npx skills add https://github.com/santoshkal/chezmoi --skill writing-beats-santoshkal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a pile of raw notes into a coherent article is hard when you try to write it all at once. This Skill breaks the process into a choose-your-own-adventure journey: you pick one beat at a time, the Skill writes only that beat, and the article grows incrementally until it reaches a natural end. ## Core Features & Use Cases - Beat-by-beat drafting: Offers 2-3 candidate starting beats from your raw material, writes only the one you pick, then proposes next beats based on where the article now stands. - Edit-safe iteration: Re-reads the article file from disk before every write, preserving your manual edits and letting substantial changes redirect what comes next. - Flexible beat sizing: A beat can be a single sentence, a short paragraph, or a multi-paragraph vignette, sized by what the move needs. - Use Case: You have a markdown file of interview notes and scattered observations. The Skill proposes three opening beats, you pick one, and together you build the article pivot by pivot until it ends naturally. ## Quick Start Use the writing-beats skill to turn my raw notes file into an article, one beat at a time, and save it 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 an article step by step?▼

Pass a markdown file of raw material and the Skill proposes 2-3 candidate starting beats. You pick one, it writes only that beat to the article file, then offers next beats until the article reaches a natural end.

What is a beat in narrative writing?▼

A beat is one move in the article's journey: it sets a scene, lands a point, asks a question, or twists the angle, then stops. It can be a single sentence or several paragraphs, sized by what the move needs.

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 previous beat, it lets that change redirect what comes next.

Does the article have to use all my raw material?▼

No. The article ends when the journey is complete, not when the pile is empty. Leftover fragments that never make it in are expected and are the point of having more raw material than needed.

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

It is less suited when you want a structured argument with a fixed outline rather than a narrative journey. The Skill is designed for assembling material as a story, not for thesis-driven or specification-style documents.