Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

nix-skills

nix-skills is a collection of portable skills that give AI coding agents (Claude Code, Codex, OpenCode, Antigravity and others) current, source-backed knowledge of Nix, NixOS, Home Manager, nix-darwin, devenv, Nixpkgs, and running coding agents on NixOS.

Agents often give Nix advice that is out of date, meant for another distribution, or imperative: nix-env -i, editing generated files, curl | sh. A skill is a folder of instructions and references that the agent loads when a request matches. With these skills installed, the agent proposes declarative, reversible changes based on the versions you actually run.

The collection installs skills, not agents. To install an agent itself on NixOS, see the nixos-coding-agents skill.

Where to start

You want toGo to
Install the skills and try themGetting started
Install for a specific agent, or without Home ManagerInstall the skills
See which skills exist and where their content comes fromSkill catalog
Understand how the references stay currentHow updates work
Add or improve a skillContribute a skill

The source is on GitHub. The catalog, the update schedule and the module options on this site are generated from the repository when the site is built, so they match the published commit.