demo

Generate reproducible markdown demo documents with executed code output.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/escotilha/claude-public --skill demo-escotilha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: demo
Source: https://github.com/escotilha/claude-public/tree/main/skills/demo
Command: npx skills add https://github.com/escotilha/claude-public --skill demo-escotilha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the drift between “what the code does” and “what the docs claim,” by generating demo documents that can be re-run and verified to match real command output.

Core Features & Use Cases

  • Reproducible executable narratives: combines commentary with code execution blocks and captured stdout.
  • Output verification loop: supports re-executing all code blocks and diffing the results to confirm nothing silently broke.
  • Demo-to-commands workflow: helps users extract the exact commands used in a demo for reuse in tickets, scripts, or PRs.
  • Typical use cases: documenting features, tools, and workflows; validating scripts before sharing; creating stable, checkable training material.

Quick Start

Ask the skill to generate a reproducible, verified markdown demo for your chosen feature or workflow by saying: /demo "showboat CLI".

Frequently Asked Questions about demo

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

FAQPage Schema
How do I create reproducible documentation with captured command output?

Reproducible documentation combines explanatory markdown with executed code blocks and captured stdout, ensuring demo documents stay accurate over time. You generate a markdown file that can be re-run and verified to match real command output.

What's the best way to verify that my markdown demo still matches real command output?

You verify markdown demos by re-executing all code blocks and diffing the results to confirm nothing silently broke. This output verification loop ensures your captured stdout remains correct over time.

Do I need Showboat to generate verifiable demo documents?

Yes, generating verifiable demo documents requires Showboat availability. The tool ensures verifiability by producing documents that can be re-run with showboat verify to compare captured output against actual results.

How do I extract exact commands from a demo for reuse in scripts or tickets?

You extract exact commands using the demo-to-commands workflow, which helps users pull the executed code blocks from a reproducible markdown demo for direct reuse in tickets, scripts, or pull requests.

What problems does executable documentation solve for engineering workflows?

Executable documentation eliminates the drift between what code does and what docs claim. It applies to documenting engineering features, tools, and workflows by combining commentary with executed code output and optional images.

Can I include images in reproducible markdown demo documents?

Yes, reproducible demo documents combine explanatory markdown with executed code output and optional images. This supports creating stable, checkable training material and validating scripts before sharing.