| name | setup-environment |
| description | Set up or verify the local development environment. Use when starting work in a fresh clone or new machine, when commands fail with missing dependencies or broken imports, or before running `make check`/`make test` for the first time in a session. |
| disable-model-invocation | true |
Setup Environment
Set up or verify the local development environment.
Steps
1. Run setup
make setup
This installs all dependencies, pre-commit hooks, and verifies that the
linter, type-checker, CLI entrypoint, and test collection all work.
2. If setup fails, diagnose
python3 --version reports < 3.11 — ask the user to install a
supported Python version.uv not found — install it: curl -LsSf https://astral.sh/uv/install.sh | shuv sync --dev fails — check for conflicting lockfiles or network
issues and report the error.databao --help fails — broken import; diagnose before proceeding
with any other work.- Lint / type-check / test collection fails — likely a code issue, not
an environment issue. Investigate the specific error.
What this skill does NOT do
- Run the full test suite — use
make test for that.
- Configure cloud credentials or Docker for E2E tests.
- Modify
pyproject.toml or add new dependencies.
