name	setup
description	Verify and auto-fix the project's development environment. Checks Python 3.13+, uv virtualenvs, Docker + OpenSearch, Node, and .env files, then auto-fixes everything project-level. Use when setting up the project, getting it running, or verifying the environment. Triggers on: set up the project, setup environment, get this running, verify my environment, /setup.
user-invocable	true

Project Setup

Verifies every prerequisite needed to run this repo and auto-fixes everything that can be safely fixed at the project level.

The Job

Get the project into a runnable state by running skills/setup/setup.sh.

Flow

Check. Run:
```
bash skills/setup/setup.sh check
```
This prints a pass/fail summary table and exits non-zero if anything fails.
If everything passed, report that the environment is ready and stop.
If anything failed, run the auto-fixer:
```
bash skills/setup/setup.sh fix
```
Re-check to confirm:
```
bash skills/setup/setup.sh check
```
If checks still fail, the remaining failures are system-level prerequisites the script will not auto-install. Surface the exact instructions to the user:
- uv not installed — https://docs.astral.sh/uv/getting-started/installation/
- Docker daemon not running — start Docker Desktop
- Node not installed / too old — https://nodejs.org/ (need >=20)
- .env placeholder values — the user must fill in real API keys in agent/.env and index/.env
- Claude Code CLI not found — the superpowers / arize-skills plugin rows show [SKIP]; install Claude Code with npm install -g @anthropic-ai/claude-code

Notes

check is read-only and safe to run anytime.
fix is idempotent — safe to run repeatedly.
The script auto-detects docker compose vs docker-compose.
fix handles project-level items (dependency syncs, Python install via uv, image pull, container start, .env creation, npm install) and Claude Code tooling (plugin install/enable, arize-ax-cli via uv tool install). System-level prerequisites — uv, Docker, Node, and the Claude Code CLI itself — are reported, never auto-installed.

Project Setup

Verifies every prerequisite needed to run this repo and auto-fixes everything that can be safely fixed at the project level.

The Job

Get the project into a runnable state by running skills/setup/setup.sh.

Flow

Check. Run:

bash skills/setup/setup.sh check

This prints a pass/fail summary table and exits non-zero if anything fails.

If everything passed, report that the environment is ready and stop.

If anything failed, run the auto-fixer:

bash skills/setup/setup.sh fix

Re-check to confirm:

bash skills/setup/setup.sh check

If checks still fail, the remaining failures are system-level prerequisites the script will not auto-install. Surface the exact instructions to the user:

uv not installed — https://docs.astral.sh/uv/getting-started/installation/
Docker daemon not running — start Docker Desktop
Node not installed / too old — https://nodejs.org/ (need >=20)
.env placeholder values — the user must fill in real API keys in agent/.env and index/.env
Claude Code CLI not found — the superpowers / arize-skills plugin rows show [SKIP]; install Claude Code with npm install -g @anthropic-ai/claude-code

Notes

check is read-only and safe to run anytime.

fix is idempotent — safe to run repeatedly.

The script auto-detects docker compose vs docker-compose.

fix handles project-level items (dependency syncs, Python install via uv, image pull, container start, .env creation, npm install) and Claude Code tooling (plugin install/enable, arize-ax-cli via uv tool install). System-level prerequisites — uv, Docker, Node, and the Claude Code CLI itself — are reported, never auto-installed.