writing-beats

Generate narrative beats and write selected beats to an article file.

Updated May 7, 2026
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill writing-beats-hgxszhj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-beats
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/in-progress/writing-beats
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill writing-beats-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps writers assemble raw material into a structured, narrative journey by guiding a beat-by-beat progression and letting the user select starting points and pivots, ensuring the story evolves in a controlled, interactive way.

Core Features & Use Cases

  • Beat-based drafting: generate and select beats that advance the story one moment at a time.
  • Starting-beat selection: present 2–3 candidate openings drawn from the raw material; user chooses the entry point.
  • Iterative pivots: after each beat, offer 2–3 next-beat options to steer the journey toward a natural ending.
  • Non-destructive editing: write only the chosen beat to the article file; preserves user edits and allows re-reading before each write.

Quick Start

Provide raw material as input and specify a save path, then the agent will generate starting beats, you pick one, and it will write only that beat to the article file before iterating pivots until the narrative ends.

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

To structure a choose-your-own-adventure narrative, this Skill transforms raw material into a sequence of narrative beats, letting you select starting points and iterative pivots to steer the journey toward a natural ending.

What is beat-by-beat narrative assembly and how does it work?

Beat-by-beat narrative assembly generates a story one moment at a time by presenting 2-3 candidate next-beat options after each written segment, allowing you to iteratively pivot the story path while maintaining single-beat writing discipline.

How do I start drafting an interactive story from existing notes?

To start drafting an interactive story, provide your raw material as input and specify a save path. The agent will generate 2-3 candidate starting beats drawn from the material for you to choose as the entry point.

Can I preserve my manual text edits while generating an article iteratively?

Yes, you can preserve manual text edits because this Skill uses non-destructive editing. It re-reads the article file before each write and appends only the single chosen beat, ensuring your previous edits remain intact.

What is the best way to control story branching when writing interactive fiction?

The best way to control story branching is through iterative pivots. After writing a single beat to the file, the agent offers 2-3 next-beat options, allowing you to steer the journey toward a clean, natural ending.