| name | check-env |
| description | Verifies required tools (Quarto, uv, Python, R, Stata, TeX) and Jupyter kernels are installed. Use when setting up or troubleshooting. |
| allowed-tools | Bash, Read, Glob, Grep |
| version | 1.0.0 |
| workflow_stage | setup |
| tags | ["environment","setup","diagnostics"] |
Check Environment
Verify that all required tools and dependencies are installed and correctly configured.
Steps
-
Check each required tool and report its version (or "not found"):
| Tool | Command | Minimum |
|---|
| Quarto | quarto --version | >= 1.4 |
| uv | uv --version | any |
| Python | python3 --version | >= 3.12 |
| R | R --version | optional |
| Stata | which stata | optional |
| TeX Live | pdflatex --version | optional (for PDF) |
| GitHub CLI | gh --version | optional |
-
Check Jupyter kernels by running uv run jupyter kernelspec list and verify:
python3 — required
ir — optional (needed for R notebooks)
nbstata — optional (needed for Stata notebooks)
-
Check the Python virtual environment:
- Verify
.venv/ exists
- Run
uv run python -c "import numpy; import pandas; import matplotlib; print('Core packages OK')" to confirm importability
-
Check nbstata configuration (if nbstata kernel is present):
- Verify
~/.config/nbstata/nbstata.conf exists
- Read it and check that
stata_dir points to an existing directory
-
Report a structured results table:
Tool/Check Status Version/Details
─────────────────────────────────────────────────
Quarto PASS 1.6.x
uv PASS 0.x.x
Python PASS 3.12.x
R PASS 4.x.x
Stata SKIP not found (optional)
TeX Live PASS 2024
GitHub CLI PASS 2.x.x
Kernel: python3 PASS installed
Kernel: ir PASS installed
Kernel: nbstata SKIP not installed
.venv/ PASS exists
Core Python packages PASS importable
nbstata.conf SKIP kernel not installed
Use PASS / FAIL / SKIP (SKIP for optional tools that are absent).
-
If any required check fails, provide the installation command or link to fix it.