Menu
Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | devenv-run-commands |
| description | Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell. |
| auto_trigger | {"keywords":["command not found","run pytest","run the tests","run python","run uv","run ruff","run the build","bare command","wrong python"]} |
This repo is managed by devenv.sh. A bare pytest / python / uv / ruff runs in a
shell without the repo's pinned PATH, env vars, and determinism settings — it will behave
differently or fail.
Always run in-repo commands as:
devenv shell -- <command>
…or use the repo's own scripts/tasks (e.g. devenv shell -- repoman doctor). For a long or
heavy command, run it in the background and poll its log rather than blocking the shell — see
the devenv-processes skill.
If a command still isn't found inside the shell, it's a venv-vs-nix-vs-script question — see the
devenv-troubleshoot skill. Background and reference: shell.md in the devenv docs export.
For when to verify vs. commit vs. release, see the repoman skill.
Use when writing a scripts/tasks/processes entry or a manager module. Covers which surface to use, guarding enterShell echoes, and the 0/1/2/3 exit contract.
Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.
Use when you edited a modules/ file, devenv.nix, or env.* and nothing changed. Resolves the lock + eval-cache staleness loop.
Use when starting a server or any long-running / heavy task. Use processes + devenv up; don't block the shell; poll logs instead of piping out of view.
Use on ModuleNotFoundError or import failures inside the devenv shell, or after a fresh venv. The venv exists but deps may not be installed.
Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.