How does the verification process work?

The skill uses the 'showboat verify' command to re-run all captured code blocks and comparisons. It ensures the demo remains accurate and the current outputs match the results recorded in the document.

Does it support accessibility testing?

Yes, for web UI features, the skill can capture accessibility trees and search for specific accessible nodes (like buttons or roles) to document the accessibility state of the interface.

What tools are required for the Demo skill?

The skill requires 'showboat' for document orchestration and 'rodney' for headless browser automation. Claude will check for these in your PATH and prompt for installation if they are missing.

Can this skill be used for backend APIs?

Yes, it supports API features by executing curl or httpie requests and capturing the JSON responses directly into the demo document using showboat's execution blocks.

When should I use the Demo skill?

Use it after a feature passes initial verification and has visible UI, API, or CLI output. It is intended for showing off working features rather than documenting internal code refactoring.

Executable Demo Generator

Name: Executable Demo Generator
Author: petrogurcak

bypetrogurcak

0•

学習とドキュメンテーション

Generates reproducible, executable demo documents with browser automation and CLI captures to provide verifiable proof of feature implementation.

The Demo skill enables Claude to create 'live' documentation that proves a feature works through actual execution rather than just claims. By leveraging showboat for document orchestration and rodney for headless browser automation, it captures real-time screenshots, API responses, and CLI outputs into standardized Markdown files. This is particularly useful after a feature passes verification, allowing developers to provide stakeholders with reproducible evidence of UI interactions, accessibility compliance, and API functionality within the project's documentation folder.

主な機能

01API and CLI command execution with real-time response logging via showboat

02Standardized Markdown demo document generation in the docs/demos/ directory

03Built-in verification step to ensure demos remain reproducible and accurate

04Automated web UI interaction and full-page screenshot capture using Rodney

05Accessibility tree analysis for UI components to document interface compliance

060 GitHub stars

ユースケース

01Providing stakeholders with verifiable proof of a new web UI feature including state-change screenshots.

02Documenting API endpoint behavior with real request/response examples for internal handoffs.

03Creating reproducible CLI usage guides that can be re-verified automatically at any time.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add petrogurcak/skills demo

For use in Claude.ai and ChatGPT