demo-optimize

Optimize demo-machine specs for pacing, narration, and visual polish.

6|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/45ck/demo-machine --skill demo-optimize
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: demo-optimize
Source: https://github.com/45ck/demo-machine/tree/main/.claude/skills/demo-optimize
Command: npx skills add https://github.com/45ck/demo-machine --skill demo-optimize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams turn a flawed or incomplete demo specification into a polished, production-ready demo workflow by enforcing structure, pacing, narration, and visual polish.

Core Features & Use Cases

  • Review and refine demo-machine specs to improve pacing, narration, and reliability
  • Add structured chapters, stable selectors, and verification steps to demos
  • Apply best practices to ensure repeatable, high-quality product demos

Quick Start

Provide a polished optimization plan for an existing .demo.yaml specification.

Frequently Asked Questions about demo-optimize

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

FAQPage Schema
How do I optimize a demo spec for better pacing and visual polish?▼

You optimize a demo spec by reviewing the demo-machine configuration to enforce structured chapters, stable selectors, and verification steps, which improves pacing, narration, and visual polish.

What does narration enforcement do when refining a production demo workflow?▼

Narration enforcement applies constraints to your demo spec to ensure the storytelling flows logically. It structures chapters to make product demos repeatable and high-quality across web and desktop apps.

Can I use demo spec optimization for both web and desktop applications?▼

Yes, demo spec optimization is applicable to production demos across both web and desktop apps. It handles simple to complex specifications by adding clear chapters and built-in validation steps.

How do I add verification steps to an existing demo-machine spec?▼

You add verification steps by reviewing the existing demo specification and applying best practices that enforce built-in validation. This ensures the production demo workflow remains reliable and repeatable.

What is the best way to structure chapters in a demo specification?▼

The best way to structure chapters in a demo specification is to enforce a clear chapter layout during spec optimization. This adds stable selectors and pacing constraints to create a repeatable, high-quality product demo.

Why does my demo workflow lack reliability during production demos?▼

Your demo workflow lacks reliability if the demo spec is missing stable selectors and built-in validation. Refining the specification with structured chapters and verification steps resolves pacing and narration issues.