skills.rest
yersonargotev
yersonargotevCOMMUNITY
Explore all skills by this author →
GitHub

writing-beats

Assembles raw markdown material into an article one beat at a time.

1|Updated Jul 5, 2026
Search Tags:#writing#markdown#editing#content structure#beats#article drafting#concept grounding
One-click install
npx skills add https://github.com/yersonargotev/packy --skill writing-beats-yersonargotev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/yersonargotev/packy/tree/main/bundle/skills/in-progress/writing-beats
Command: npx skills add https://github.com/yersonargotev/packy --skill writing-beats-yersonargotev

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 in an order the reader can follow. This Skill structures that process as a beat-by-beat journey where every concept is grounded before any later beat relies on it. ## Core Features & Use Cases - Grounding Tracking: Maintains a running list of concepts the audience already knows, and only offers beats reachable from that grounded set. - Choose-Your-Own-Adventure Drafting: Proposes 2-3 candidate next beats at each step, writes only the chosen beat to the article file, then re-reads the file before continuing. - Use Case: You have a markdown file of raw research notes for a blog post. The Skill helps you pick a starting beat, drafts it, then iteratively offers next directions until the article reaches a natural end. ## Quick Start Use the writing-beats skill to turn my raw notes file into an article, saving the draft 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 article writing?▼

A beat is one move in the article: a sentence, paragraph, or short vignette that does a single thing and stops. If a beat needs multiple subheadings, it should be split into separate beats.

How does concept grounding work when drafting an article?▼

Every concept must be grounded before a beat can use it, either as a prerequisite the audience already knows or as an idea introduced by an earlier beat. The Skill keeps a running list of grounded concepts and only offers beats reachable from it.

Can I rewrite or go back to an earlier beat?▼

Yes. Ask to rewrite a beat or try a different one and the Skill edits it in place, leaving the rest of the article untouched. It re-reads the file from disk before every write, so manual edits are preserved.

When should I not use a beat-by-beat writing workflow?▼

Avoid it when you need a complete draft in one pass or when the material is already structured. The workflow is interactive and writes one beat at a time, so it suits exploratory drafting rather than bulk generation.

Related Skills

Explore More Content & Communication Skills→
RUSHYOPRUSHYOP

Obsidian

Convert raw transcripts into structured, linked Obsidian notes with tags.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

publishing

Format and distribute finalized content to publishing platforms with scheduling and verification.

Official
Intermediate
cjohnhansoncjohnhanson

doc-coauthoring

Guide collaborative document writing through context gathering, drafting, reader testing, and fact-checking.

Community
Advanced
JlsilesJlsiles

content-repurpose

Turn transcripts, articles, or talks into platform-specific newsletters, social posts, threads, and video scripts.

Community
Intermediate