Create executable Markdown demos using showboat to prove features work. Use after implementing features or fixing bugs to produce reproducible proof-of-work documents.
From showboatnpx claudepluginhub betamatt/claude-plugins --plugin showboatThis skill uses the workspace's default tool permissions.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Showboat is a CLI tool that constructs Markdown documents by capturing real command output. Each exec block runs a command, records the output, and appends both to the document. The result is a reproducible demo that proves code works — not just that tests pass.
Install: go install github.com/simonw/showboat@latest
Do NOT use for:
init → note → exec → exec → ... → verify
# Create the demo document
showboat init demos/users-api.md 'Users API'
# Describe what we're demonstrating
showboat note demos/users-api.md 'Create a user and verify the response'
# Execute and capture API calls
showboat exec demos/users-api.md bash \
'curl -s -X POST http://localhost:3000/users \
-H "Content-Type: application/json" \
-d "{\"name\":\"test\"}" | jq .'
showboat exec demos/users-api.md bash \
'curl -s http://localhost:3000/users | jq .'
# Verify the demo is reproducible
showboat verify demos/users-api.md
showboat init demos/my-cli.md 'My CLI Tool'
showboat note demos/my-cli.md 'Show help output'
showboat exec demos/my-cli.md bash 'my-cli --help'
showboat note demos/my-cli.md 'Run a basic command'
showboat exec demos/my-cli.md bash 'my-cli process input.txt'
showboat verify demos/my-cli.md
Name demo files after the feature: demos/<feature>.md
Examples: demos/users-api.md, demos/email-sync.md, demos/search.md
If an exec captures bad output (wrong response, error, etc.):
# Remove the last section
showboat pop demos/feature.md
# Fix the issue, then retry
showboat exec demos/feature.md bash 'fixed-command'
pop removes the most recent entry (note, exec, or image). Call it multiple times to remove multiple entries.
verify re-runs every exec block and compares output to what was recorded:
showboat verify demos/feature.md
Use --output to write an updated version without modifying the original:
showboat verify demos/feature.md --output demos/feature-updated.md
jq . for readabilitycurl -s)showboat verify to confirm reproducibility