NixOS AI Skill

Auto-updated NixOS and Nix documentation for AI coding assistants.

Uses the open Agent Skills standard (SKILL.md). Works with 33+ AI coding assistants including Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Gemini CLI, Amp, OpenCode, Cline, Aider, Goose, Roo Code, and many more.

References are auto-generated daily from four official NixOS repositories via GitHub Actions.

Sources

Repository	What it provides
NixOS/nix.dev	Tutorials, guides, best practices, glossary
NixOS/nixpkgs nixos/doc/manual/	NixOS manual (installation, configuration, administration, modules)
NixOS/nix-pills	Progressive Nix learning series (20 lessons)
NixOS/release-wiki	NixOS release process documentation

Install

Quick start

Clone into whichever directory your AI tool reads context from:

# Cursor
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .cursor/skills/nixos

# Windsurf
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .windsurf/skills/nixos

# GitHub Copilot
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .github/skills/nixos

# Cline
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .cline/skills/nixos

# Claude Code (global, all projects)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git ~/.claude/skills/nixos

# Claude Code (project-local)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .claude/skills/nixos

# OpenCode
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .opencode/skills/nixos

# Aider
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .aider/skills/nixos

# Amp
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .amp/skills/nixos

# ForgeCode
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .forgecode/skills/nixos

# Gemini CLI
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .gemini/skills/nixos

# OpenAI Codex
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .agents/skills/nixos

# Cross-agent standard (works with any Agent Skills compatible tool)
git clone https://github.com/marceloeatworld/nixos-ai-skill.git .agents/skills/nixos

With the install script

curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --claude
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --cursor
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --windsurf
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --copilot
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --opencode
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --amp
curl -fsSL https://raw.githubusercontent.com/marceloeatworld/nixos-ai-skill/main/install.sh | bash -s -- --custom /path/you/want

Run ./install.sh --help for all options.

Update

git -C <install-path> pull