Skip to main content
AI/MLterrylica

setup

Check and install dependencies for asciinema-tools. TRIGGERS - setup, check deps, preflight.

Stars
49
Source
terrylica/cc-skills
Updated
2026-05-30
Slug
terrylica--cc-skills--setup
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/terrylica/cc-skills/HEAD/plugins/asciinema-tools/skills/setup/SKILL.md -o .claude/skills/setup.md

Drops the SKILL.md into .claude/skills/setup.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

/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.