narrate-spec

Generate per-chapter and per-step narration for demo-machine YAML specs.

6|1|Updated Feb 14, 2026

Search Tags:#storytelling #narration #ai-writing #tone-control #demo-spec #yaml-editing

Ready to run

npx skills add https://github.com/45ck/demo-machine --skill narrate-spec

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: narrate-spec
Source: https://github.com/45ck/demo-machine/tree/main/.claude/skills/narrate-spec
Command: npx skills add https://github.com/45ck/demo-machine --skill narrate-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Narration gaps in demo-machine specs slow product demos and reduce clarity. This skill automatically generates cohesive, readable narration that explains the user journey across chapters and steps, aligning with a chosen tone.

Core Features & Use Cases

Generates chapter-level and step-level narration that follows a coherent narrative arc.
Supports tone options (formal, casual, technical) to fit presentation style.
Edits the spec file by adding narration fields without altering actions, selectors, or structure.

Quick Start

Run narrate-spec with your demo YAML to generate chapter and step narrations.

Frequently Asked Questions about narrate-spec

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

FAQPage Schema

How do I generate narration for my demo YAML spec?▼

To generate narration for a demo YAML spec, run the narrate-spec tool on your .demo.yaml file to automatically add per-chapter and per-step narration fields without altering existing actions or selectors. It creates a cohesive narrative arc across the entire user journey.

Can I control the tone of AI-generated narration for demo specs?▼

Yes, you can control the tone of AI-generated narration by applying optional formal, casual, or technical tone options to match your specific presentation style and audience requirements when generating demo spec narration.

What is the best way to add narration to a demo-machine YAML file?▼

The best way to add narration to a demo-machine YAML file is to use an automated narration skill that inputs your .demo.yaml and injects chapter-level and step-level narration fields, preserving the original structure while validating the output via a CLI workflow.

Will adding narration fields change the actions or selectors in my demo spec?▼

No, adding narration fields will not change the actions or selectors in your demo spec. The narration generation process strictly edits the file by injecting narration text fields while preserving the original actions, selectors, and structural integrity.

Do I need a specific CLI workflow to validate narrated demo specs?▼

Yes, you need a CLI workflow to validate narrated demo specs after the narration fields are added to your .demo.yaml file, ensuring the generated per-chapter and per-step narration integrates correctly without breaking the existing spec structure.