Nix Agent Init

Generates AGENT_MAP.md/CLAUDE.md/.mcp.json for a NixOS or Home Manager repo, fact-traced via the nix-agent MCP server.

Works with setup

Test report

Verdict
Works with setup
Score
8.8/10
Tested
Jul 16, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 40d3fd1

Self-contained SKILL.md with an unusually disciplined no-invention, marker-bounded re-run contract, but it hard-depends on a separate nix-agent CLI+MCP server (a companion project requiring Nix itself, not on npm/brew) that isn't present in a normal environment; simulating the fact bundle by hand still produced grounded, fact-cited AGENT_MAP.md/CLAUDE.md/.mcp.json clearly better than a generic no-skill onboarding doc.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 7/10
  • Docs & honesty 5/5

What Nix Agent Init does

Onboards a NixOS/Home Manager flake config repo for coding agents: runs `nix-agent inspect-flake` to get a fact bundle, then writes an AGENT_MAP.md routing table, a one-screen CLAUDE.md/AGENTS.md brief, and a .mcp.json wiring nix-agent and mcp-nixos — every line traced to an observed fact, with a marker-based contract so re-runs never clobber hand-written content. Triggers when the user wants a Nix repo made agent-ready and the host already exposes the nix-agent MCP server.

How to install Nix Agent Init

git clone https://github.com/JEFF7712/nix-agent
cd nix-agent
mkdir -p ~/.claude/skills
cp -r skills/nix-agent-init ~/.claude/skills/nix-agent-init

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Nix Agent Init

  • /nix-agent-init Generates AGENT_MAP.md/CLAUDE.md/.mcp.json for a NixOS or Home Manager repo, fact-traced via the nix-agent MCP server.

It also activates on plain-language prompts like these:

  • Make this NixOS flake repo ready for coding agents with a map file
  • Generate an AGENT_MAP and CLAUDE.md for my Home Manager config repo
  • Wire up MCP servers so agents can safely inspect my Nix flake config

Frequently asked questions

Is the Nix Agent Init skill free?
Yes. The skill itself is free from JEFF7712/nix-agent. SkillProof publishes the install command and an independent test verdict at no cost.
Does Nix Agent Init work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 16, 2026. Verdict: Works with setup. Self-contained SKILL.md with an unusually disciplined no-invention, marker-bounded re-run contract, but it hard-depends on a separate nix-agent CLI+MCP server (a companion project requiring Nix itself, not on npm/brew) that isn't present in a normal environment; simulating the fact bundle by hand still produced grounded, fact-cited AGENT_MAP.md/CLAUDE.md/.mcp.json clearly better than a generic no-skill onboarding doc.
What is the Nix Agent Init SkillProof Score?
8.8/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 5/5.
How do I install Nix Agent Init?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Nix Agent Init with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.