writing-beats

Write narrative articles beat-by-beat from raw material with user-selected pivots.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns scattered raw material into a cohesive, narrative article by writing one “beat” at a time that the reader can steer through a choose-your-own-adventure path.

Core Features & Use Cases

  • Beat-based assembly: Writes only a single story move (one sentence to multiple paragraphs) at each step to keep structure flexible and token-efficient.
  • User-directed starting and pivots: Offers multiple starting-beat options, then repeatedly offers diverging next-beat directions based on what’s already written.
  • Narrative rather than argument: Builds a journey of scenes, questions, twists, and asides instead of forcing a fixed intro/body/conclusion outline.

Use cases include transforming raw research notes, interview transcripts, or a pile of markdown fragments into an engaging story-driven article.

Quick Start

Ask the AI to run the writing-beats flow using your attached raw-material markdown file and to save the article to the path you specify, writing only the chosen first beat.

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 markdown notes into a choose-your-own-adventure narrative?

To turn raw markdown notes into a choose-your-own-adventure narrative, the writing-beats process builds a story iteratively by offering starting entry points and subsequent direction pivots beat-by-beat. It transforms scattered fragments into a cohesive, story-driven article without forcing a fixed outline.

What is beat-by-beat storytelling for markdown research notes?

Beat-by-beat storytelling for markdown research notes is a method of assembling a narrative article by writing one single story move at a time. This approach keeps the structure flexible and token-efficient, allowing the user to steer the journey through scenes, questions, and twists rather than following a rigid intro-body-conclusion format.

How do I write a narrative article from interview transcripts step by step?

To write a narrative article from interview transcripts step by step, attach your raw material and instruct the AI to start the flow. It will offer candidate starting beats, write only the chosen single beat, re-read the file from disk, and then repeatedly offer diverging next-beat directions until a natural narrative ending is reached.

Can I use a choose-your-own-adventure format to convert raw notes into an article?

Yes, you can use a choose-your-own-adventure format to convert raw notes into an article by selecting a starting entry point and subsequent direction beat-by-beat. This approach builds a narrative journey of scenes and asides instead of forcing a traditional fixed argument or outline structure.

What is the best way to structure an article from scattered markdown fragments?

The best way to structure an article from scattered markdown fragments is using an iterative, user-directed narrative approach. By writing only one beat at a time and selecting diverging next-beat directions based on what is already written, you create an engaging story-driven article that remains flexible and token-efficient.

When should I avoid using a beat-by-beat narrative format for my content?

You should avoid using a beat-by-beat narrative format when your material requires a strict, logical argument with a fixed intro-body-conclusion outline. This approach is designed for building a journey of scenes, questions, and twists rather than forcing a structured argument or standard informational document.