Menu
Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.
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
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 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 when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.
Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.
| name | devenv-inputs |
| description | Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs. |
| auto_trigger | {"keywords":["devenv.yaml","add input","add import","flake false","nixpkgs-python","module input","transitive input","version pin nix"]} |
Three rules cover most input mistakes:
A devenv-module input needs flake: false. Without it, devenv tries to evaluate the input
as a flake and the import fails.
inputs:
repoman:
url: path:../repoman/modules
flake: false
Pinning languages.python.version needs the nixpkgs-python input. A bare version string
with no such input silently won't resolve.
Remote module imports merge devenv.nix, not devenv.yaml. A module you import does not
bring its own inputs along — you must declare its transitive inputs in your devenv.yaml.
After any devenv.yaml change, re-lock: rm -f devenv.lock (or devenv update <input>) — see the
devenv-module-edits skill. Grep-able detail: inputs-and-imports.md.
For when in the lifecycle to do this, see the repoman skill.