skills.rest
45ck
45ckCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/45ck/demo-machine --skill narrate-spec
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
45ck45ck
6

translate-spec

Translate narration and UI text in .demo.yaml files to a target language.

Community
Intermediate
45ck45ck
6

demo-iterate

Automate run-review-fix cycles for .demo.yaml demo specifications.

Community
Intermediate
lifeodysseylifeodyssey
1

humanizer

Detect and rewrite AI-writing patterns to produce natural human-sounding text.

Community
Intermediate
gqf2008gqf2008

nano-pdf

Edit PDF text and titles on specific pages using natural-language instructions.

Community
Intermediate