# Check Env

> Check Env is an Agent Skill for testing & quality published in the brycewang-stanford/Auto-Empirical-Research-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `check-env`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/HEAD/skills/29-quarcs-lab-project20XXy/dot-claude/skills/check-env/SKILL.md
- Repository: brycewang-stanford/Auto-Empirical-Research-Skills (2,866 GitHub stars when collected)

## SKILL.md

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

---

Source: https://www.openparable.com/skill/testing-quality/check-env (OpenParable). Cite the canonical URL above.
