Skip to main content

Skill.md

check-env

Verifies required tools (Quarto, uv, Python, R, Stata, TeX) and Jupyter kernels are installed. Use when setting up or troubleshooting.

SKILL.md

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

# Check Environment

Verify that all required tools and dependencies are installed and correctly configured.

## Steps

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

2. 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)

3. Check the Python virtual environment:
   - Verify `.venv/` exists
   - Run `uv run python -c "import numpy; import pandas; import matplotlib; import jupytext; print('Core packages OK')"` to confirm importability

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

5. 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).

6. If any required check fails, provide the installation command or link to fix it.

When Claude will use it

Use when setting up or troubleshooting.