Create executable markdown demos that record commands and stable outputs.
npx skills add https://github.com/withakay/research --skill showboat-withakay
Please help me install this Agent Skill. Skill: showboat Source: https://github.com/withakay/research/tree/main/.agents/skills/showboat Command: npx skills add https://github.com/withakay/research --skill showboat-withakay
This Skill solves the problem of creating reproducible demonstration documents that can be used to prove repo behavior with executable markdown, which is especially useful for tests, CLI, local services, Aspire AppHosts, and HTTP APIs.
uvx showboat to add notes, execute commands, and verify the document's reproducibility.Initialize a Showboat document for a demo, add context, execute commands, and verify the output:
uvx showboat init demos/<name>.md "<Readable Demo Title>"
uvx showboat note demos/demo.md "This demonstrates the integration path."
uvx showboat exec demos/demo.md bash "uv run pytest -q"
uvx showboat verify demos/demo.md
High-intent search queries and answers about installing and using this skill.
You can create reproducible executable markdown demos by initializing a Showboat document, adding context notes, executing commands directly within the markdown, and running a verification step to ensure stable output replay.
Executable markdown proofing generates demonstration documents that verify software workflows by recording commands and stable outputs. It is needed for proving repo behavior in tests, CLI operations, local services, Aspire AppHosts, and HTTP APIs.
Yes, Showboat supports creating Aspire-backed demos by keeping the AppHost lifecycle inside a helper script, allowing you to focus on capturing and verifying stable proof lines from the integration output.
Initialize the document with a title, add context using notes, execute commands like tests or API calls directly into the file, and run the verify command to check the reproducibility of the recorded workflow outputs.
Yes, the quick start process uses uvx to run Showboat commands for initializing markdown files, adding notes, executing bash commands, and verifying the reproducible demonstration documents.
Executable markdown reproducibility relies on stable command outputs; workflows with volatile, time-sensitive, or non-deterministic outputs may fail verification and require careful command structuring to maintain stable proof lines.
CommunityToolkitManage Aspire distributed applications through the Aspire CLI.
Cmwilson05Embed live command outputs into Markdown documents using the showboat CLI.
signalbeam-ioStart the Aspire AppHost locally with preflight checks and optional frontend launch.
rafaelcallejaTransform ad hoc Bash commands into documented Makefile targets.