Bootstrap and navigate the spec-kit demo environment. Use this when asked to set up the demo, bootstrap the demo, jump to a phase, go to a phase, switch phases, or clean up a demo.
Install
mkdir -p .claude/skills/demo && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14303" && unzip -o skill.zip -d .claude/skills/demo && rm skill.zipInstalls to .claude/skills/demo
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Bootstrap and navigate the spec-kit demo environment. Use this when asked to set up the demo, bootstrap the demo, jump to a phase, go to a phase, switch phases, or clean up a demo.About this skill
Demo Skill
This skill manages the spec-kit staged demo environment using git worktrees and phase tags.
When to Use
Use this skill when the user asks to:
- Set up / bootstrap / prepare the demo
- Jump to / go to / switch to a phase
- Clean up / delete / remove a demo
- Reset the demo
Setup
Run from the repository root to create the demo environment:
# Auto-numbered (demo-01, demo-02, etc.)
.\.github\skills\demo\setup-demo.ps1
# Named demo
.\.github\skills\demo\setup-demo.ps1 -Name mcaps
This creates a demo folder (e.g., ../sdd-health-plan-chat-mcaps/) containing:
live/— Editable worktree for the demophase-00-init/,phase-01-constitution/, etc. — Checkpoint worktrees (for offline resilience)
Setup Options
| Option | Description |
|---|---|
-Name <name> | Name for the demo (creates <repo>-<name>) |
-SkipCheckpoints | Create only the live worktree |
-Reset | Remove existing worktrees and recreate |
-WorktreeRoot <path> | Override full path for demo folder |
Jump to Phase
From within the live worktree, jump between phases while preserving work:
.\.github\skills\demo\jump-to-phase.ps1 -Phase <phase>
Safety:
- The script refuses to run on
main/master. - In a demo worktree, it runs without extra prompts.
- Outside a worktree, it prints a warning (because changes may affect your main repo).
State preservation: When jumping away from a phase, uncommitted changes are stashed. When returning, they're automatically restored.
Stash identity: Stashes are labeled as demo[<name>]:<phase-tag>.
- If you are on a
demo/<name>branch,<name>comes from the branch. - Otherwise (common in spec-kit demos),
<name>is derived from the demo folder name (e.g.,../sdd-health-plan-chat-dry-run/live→dry-run).
Phase Identifiers
| Number | Name | Tag |
|---|---|---|
0 | init | phase/00-init |
1 | constitution | phase/01-constitution |
2 | spec | phase/02-spec |
3 | plan | phase/03-plan |
4 | tasks | phase/04-tasks |
5.1 | setup | phase/05-implement/01-setup |
5.2 | foundational | phase/05-implement/02-foundational |
5.3 | us1 | phase/05-implement/03-ask-plan-questions |
5.4 | us2 | phase/05-implement/04-handle-missing-answers |
5.5 | us3 | phase/05-implement/05-ui |
5.6 | docs | phase/05-implement/06-documentation |
Jump Options
| Option | Description |
|---|---|
-Phase <id> | Phase number, name, or full tag |
-Reset | Discard changes instead of stashing; skip restore |
Examples
# Jump to plan phase (preserves current work)
.\.github\skills\demo\jump-to-phase.ps1 -Phase plan
# Jump to phase 5.3 and discard changes
.\.github\skills\demo\jump-to-phase.ps1 -Phase 5.3 -Reset
# Jump using full tag name
.\.github\skills\demo\jump-to-phase.ps1 -Phase phase/03-plan
After Setup
- Open the live worktree:
code ../sdd-health-plan-chat-<name>/live - Jump between phases as needed during the demo
- Use
-Reseton setup-demo.ps1 to start fresh
Cleanup
Remove a demo environment (folders, branch, and stashes):
# Clean up a specific demo
.\.github\skills\demo\cleanup-demo.ps1 -Name mcaps
# Clean up all demos
.\.github\skills\demo\cleanup-demo.ps1 -All
Cleanup Options
| Option | Description |
|---|---|
-Name <name> | Name of the demo to remove |
-All | Remove all demo environments |
-KeepStashes | Preserve stashes (only remove folders and branches) |