---
name: setup
description: Check and install dependencies for asciinema-tools. TRIGGERS - setup, check deps, preflight.
allowed-tools: Bash, AskUserQuestion
argument-hint: "[check|install|repair] [--all] [--core] [--optional] [-y|--yes]"
model: haiku
disable-model-invocation: false
---

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

```bash
# 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.