← LeaderboardThe Skill Leaderboard

env-snapshot

Captures tool versions, packages, and kernel info as a reproducibility record in notes/. Use when documenting the environment.

Published by brycewang-stanford ↗brycewang-stanford/Auto-Empirical-Research-Skills

Try your first task

env-snapshot

Start a fresh conversation.

Use env-snapshot to with my explicit consent, capture the current local reproducibility environment and save a dated Markdown snapshot in notes/, including available tools, kernels, and package/session details; report the saved path.

    User-approved starter prompt based on a pinned source version; check current skill requirements before running. Task evidence ↗

    SKILL.md

    name: env-snapshotdescription: Captures tool versions, packages, and kernel info as a reproducibility record in notes/. Use when documenting the environment.allowed-tools: Bash, Read, Write, Glob, Grep

    Document Environment Snapshot

    Capture the full environment state and save it as a reproducibility record.

    Steps

    1. Gather system and tool versions:

      uname -a                    # OS info
      quarto --version            # Quarto
      uv --version                # uv
      python3 --version           # Python
      
    2. Capture Python package versions:

      uv pip list                 # all installed packages with versions
      
    3. Capture Jupyter kernel list:

      uv run jupyter kernelspec list
      
    4. If R is available, capture R session info:

      R -e "sessionInfo()"
      
    5. If Stata is available, note the version:

      which stata                 # or check nbstata.conf for edition info
      

      Read ~/.config/nbstata/nbstata.conf for stata_dir and edition.

    6. If TeX Live is available:

      pdflatex --version | head -1
      
    7. Generate a timestamped Markdown file with all collected information:

      # Environment Snapshot — YYYY-MM-DD
      
      ## System
      - OS: ...
      - Platform: ...
      
      ## Tools
      | Tool | Version |
      | ---- | ------- |
      | Quarto | x.x.x |
      | uv | x.x.x |
      | Python | 3.12.x |
      | R | x.x.x (or N/A) |
      | Stata | SE x.x (or N/A) |
      | TeX Live | xxxx (or N/A) |
      
      ## Jupyter Kernels
      - python3: /path/to/kernel
      - ir: /path/to/kernel (or N/A)
      - nbstata: /path/to/kernel (or N/A)
      
      ## Python Packages
      | Package | Version |
      | ------- | ------- |
      | numpy | x.x.x |
      | pandas | x.x.x |
      | ... | ... |
      
      ## R Session Info
      (full sessionInfo() output, or "R not available")
      
      ## Stata Packages
      (ado dir output, or "Stata not available")
      
    8. Save to notes/environment-YYYYMMDD.md (using today's date).

    9. Report the file path.