writing-beats

Organize raw material into structured article beats with concept grounding.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/yash-garg/pi-config --skill writing-beats-yash-garg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/yash-garg/pi-config/tree/main/skills/writing-beats
Command: npx skills add https://github.com/yash-garg/pi-config --skill writing-beats-yash-garg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps writers transform a fixed collection of raw material into a coherent article journey by organizing ideas into grounded, sequential beats instead of drafting disconnected sections.

Core Features & Use Cases

  • Beat-Based Writing Flow: Guides users through choosing starting points, writing one beat at a time, and building an article through deliberate narrative progression.
  • Concept Grounding Management: Tracks which ideas are established before allowing later sections to depend on them, keeping explanations accessible and logically connected.
  • Use Case: A writer with a large markdown research file can use this Skill to explore possible article structures, select a path, and progressively compose a finished piece while preserving reader understanding.

Quick Start

Use the writing-beats skill with my markdown file of raw material to create an article by guiding me through beat selection and writing.

Frequently Asked Questions about writing-beats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure raw markdown notes into a coherent article?

You can structure raw markdown notes into a coherent article by organizing ideas into sequential beats and tracking concept prerequisites. This approach builds a narrative progression instead of drafting disconnected sections, ensuring logical flow and reader accessibility.

What is beat-based writing and how does concept grounding work for content planning?

Beat-based writing guides you through selecting a starting point and writing one section at a time. Concept grounding tracks which ideas are established before allowing later sections to depend on them, keeping explanations logically connected and accessible to readers.

Can I use my existing markdown research files for article structure planning?

Yes, you can use existing markdown research files as raw input material. The writing workflow transforms these content piles into a structured sequence of article beats, allowing you to explore possible structures and progressively compose a finished piece.

How do I maintain narrative consistency when writing an article incrementally?

You maintain narrative consistency through interactive beat selection and incremental document updates. By tracking prerequisite concepts as you write, the workflow ensures later sections only depend on ideas already established in earlier beats.

What is the best way to turn research notes into an explanatory journey?

The best way to turn research notes into an explanatory journey is organizing raw material into a deliberate sequence of grounded beats. This method transforms fixed collections of notes into a coherent narrative path through interactive selection and prerequisite tracking.