Willem van den Ende 237dcb48b2 Port DEMO skill from claude to pi

And particular for this project. I am now reading more markdown, making
smaller steps. So the installation instructions went to the README.

Hmm. having just written about init scripts, the installation may be
best moved to an init script in the skill directory.

2026-05-14 11:18:29 +01:00

1.4 KiB

Raw Blame History

Demo Skill

Generate living demo documents proving features work, with showboat for Markdown assembly and rodney for browser screenshots.

Prerequisites

Requires two Go CLI tools:

go install github.com/simonw/showboat@latest
go install github.com/simonw/rodney@latest

Verify installation:

showboat --help
rodney --help

Usage

In pi, invoke via:

/skill:demo <feature-name> [--scenario <description>] [--plan <path>]

Or ask naturally:

"demo this"
"show me it works"
"create a demo"
"create a demo of the authentication flow"

How It Works

Checks that showboat and rodney are installed
Gathers feature context from plan files, recent commits, or your description
Verifies the dev server is running
Handles authentication (creates a demo user if needed)
Captures backend evidence (tests, compilation, database state)
Takes browser screenshots of UI pages
Maps evidence to acceptance criteria
Produces a standalone Markdown demo document in demos/

Demo Document Structure

Feature Overview — narrative description
Test Suite — relevant test output
Compilation Check — mix compile --warnings-as-errors
Database State — if relevant
UI Screenshots — static pages and interactive flows
Acceptance Criteria Verification — checklist with evidence references

1.4 KiB Raw Blame History