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.

Funktioniert mit Setup ★ 8.8/10

Was es kann

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.

Testbericht

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.

Getestet am: 2026-07-16 · Claude Code 2.x (agent harness)

Installation

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

Befehle & Beispiel-Prompts

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

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →