stabilize-beats

Analyze a book's 15-beat outline and generate beat-to-section coverage recommendations.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/bonjohen/tasty --skill stabilize-beats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stabilize-beats
Source: https://github.com/bonjohen/tasty/tree/main/.claude/skills/stabilize-beats
Command: npx skills add https://github.com/bonjohen/tasty --skill stabilize-beats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill evaluates whether a book's beat outline is structurally stable enough to proceed to section expansion, identifying splits, braiding opportunities, blockers, and an actionable beat-to-section coverage plan.

Core Features & Use Cases

  • Beat file analysis: Reads books/[name]/docs/15_beats.md plus optional story context files to assess each beat's readiness.
  • Decision pass orchestration: Spawns a beat-analyzer agent to run a structured Beat Expansion decision pass and synthesizes per-beat recommendations and a coverage plan.
  • Repository updates & user flow: Presents findings to the user, captures approval to mark beats as Stable or Locked, and updates the beats status header and mapping when authorized.
  • Use Case: Use this Skill before expanding sections to ensure the backbone is consolidated and to avoid wasted drafting on unstable beats.

Quick Start

Run stabilize-beats for the target book to evaluate beat readiness and generate a beat-to-section coverage recommendation.

Frequently Asked Questions about stabilize-beats

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

FAQPage Schema
How do I assess if my story outline is ready for section expansion?

Assess story outline readiness for section expansion by running a Beat Expansion decision pass that reads the 15-beat outline and story docs to identify structural splits, braiding opportunities, and blockers, returning per-beat recommendations.

What is beat stability analysis in book writing workflows?

Beat stability analysis evaluates whether a book's 15-beat outline is structurally consolidated enough to proceed, generating a beat-to-section coverage plan to prevent wasted drafting on unstable beats.

How do I generate a beat-to-section coverage plan before drafting?

Generate a beat-to-section coverage plan by applying a beat-analyzer agent to your 15_beats.md file and related story context, which synthesizes actionable expansion recommendations and identifies structural splits.

Can I automatically update beat status and mapping in my book repository?

You can update beat status and mapping by authorizing repository changes after the analysis, marking beats as Stable or Locked and updating the beats status header directly in the book directory.

What story files do I need to run a beat readiness check?

Running a beat readiness check requires the books/[name]/docs/15_beats.md file, supplemented by optional story context documents that provide additional narrative background for the agent's decision pass.

When should I avoid proceeding to section expansion from an unstable outline?

Avoid proceeding to section expansion when the beat analysis identifies structural blockers, indicating the backbone is not yet consolidated and drafting would waste effort on unstable narrative beats.