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.