setup

/asciinema-tools:setup

Check and install all dependencies for asciinema-tools.

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

Arguments

Argument	Description
check	Run preflight check (default)
install	Install missing dependencies
repair	Reinstall/upgrade all components
--all	Install all (core + optional)
--core	Install core only (asciinema, rg)
--optional	Install optional only
-y, --yes	Skip confirmation prompts

Dependencies

Component	Type	Installation
asciinema	Core	brew install asciinema
ripgrep	Core	brew install ripgrep
iTerm2	Optional	brew install --cask iterm2
fswatch	Optional	brew install fswatch
gh CLI	Optional	brew install gh
YAKE	Optional	uv run --with yake

Execution

Skip Logic

• If action provided -> skip Phase 1 (action selection)
• If --core/--all/--optional provided -> skip Phase 2
• If -y provided -> skip all confirmations

Workflow

1. Check: Run preflight for all dependencies
2. Action: AskUserQuestion for action type
3. Selection: AskUserQuestion for components
4. Install: Run selected installations
5. Verify: Confirm installation success

Examples

# Check all dependencies
/asciinema-tools:setup check

# Install core dependencies
/asciinema-tools:setup install --core

# Install everything without prompts
/asciinema-tools:setup install --all -y

Troubleshooting

Issue	Cause	Solution
brew not found	Homebrew not installed	Install from https://brew.sh
Permission denied	Need sudo for install	Run brew doctor for diagnostics
asciinema not found	PATH not updated	Restart terminal or source profile
gh auth failed	Not authenticated	Run gh auth login
YAKE import error	Python package missing	uv pip install yake

Post-Execution Reflection

After this skill completes, check before closing:

1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.