/ Verzeichnis / Playground / agent-skills-nix
● Community Kyure-A ⚡ Sofort

agent-skills-nix

von Kyure-A · Kyure-A/agent-skills-nix

Manage your Claude Agent Skills declaratively with Nix — reproducible skill sets across machines.

A Nix flake that lets you declare your Agent Skills in Nix config and have them materialized into ~/.claude/skills/ (or any target). Useful if you already live in NixOS or Home Manager and want your skill setup to be as reproducible as the rest of your dotfiles.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

agent-skills-nix-skill.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-skills-nix-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Kyure-A/agent-skills-nix",
        "~/.claude/skills/agent-skills-nix"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-skills-nix-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Kyure-A/agent-skills-nix",
        "~/.claude/skills/agent-skills-nix"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-skills-nix-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Kyure-A/agent-skills-nix",
        "~/.claude/skills/agent-skills-nix"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-skills-nix-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Kyure-A/agent-skills-nix",
        "~/.claude/skills/agent-skills-nix"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-skills-nix-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Kyure-A/agent-skills-nix",
        "~/.claude/skills/agent-skills-nix"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-skills-nix-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Kyure-A/agent-skills-nix",
          "~/.claude/skills/agent-skills-nix"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add agent-skills-nix-skill -- git clone https://github.com/Kyure-A/agent-skills-nix ~/.claude/skills/agent-skills-nix

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: agent-skills-nix

How to declare your Claude skills in a Nix flake

👤 NixOS / Home Manager users ⏱ ~25 min intermediate

Wann einsetzen: You want your Claude skill set tracked the same way as your shells, editors, and services.

Voraussetzungen
  • Nix with flakes enabled — echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
  • The flake added as an input — flake input agent-skills-nix.url = "github:Kyure-A/agent-skills-nix";
Ablauf
  1. Add the input
    Add agent-skills-nix to my flake inputs and wire it into Home Manager.✓ Kopiert
    → flake.nix updated with the input + module import
  2. List the skills I want
    Declare the skills I use: linear-claude-skill, symfony-ux-skills, mck-ppt-design-skill. Pin to current main.✓ Kopiert
    → A skills = { ... }; block with pinned revs
  3. Build and switch
    Run home-manager switch and verify ~/.claude/skills/ is populated.✓ Kopiert
    → All skills present as symlinked directories

Ergebnis: Reproducible skill set managed by Nix — wipe your dotfiles and get the same setup back in one command.

Fallstricke
  • Upstream skill changes break your workflow — Pin to a specific rev, only bump on purpose
Kombinieren mit: filesystem

Sync the same skill set across laptop and workstation

👤 Multi-machine developers ⏱ ~15 min intermediate

Wann einsetzen: You switch between a laptop and a desktop and keep forgetting to clone the same skills on both.

Ablauf
  1. Add to your shared HM module
    Move the skills declaration into my shared home-manager module so both hosts import it.✓ Kopiert
    → Single source of truth, two hosts consuming it
  2. Switch both hosts
    Build and switch on both machines.✓ Kopiert
    → Matching ~/.claude/skills/ on both

Ergebnis: Both machines carry the same skill bundle automatically.

Fallstricke
  • Forgetting to commit and push before switching on the second machine — Use a self-flake with autoCommit or a shared git repo

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

agent-skills-nix-skill + filesystem

Claude reads your flake and suggests skills to add/remove

Read my flake.nix, check which of my installed skills haven't been used in 30 days, and suggest removals.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
skill-declaration set of { name, url, rev } During home-manager switch / nixos-rebuild nix build runtime
lock-management flake.lock When you want deterministic upgrades 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
none
Tokens pro Aufruf
minimal — Nix declarations are short
Kosten in €
free
Tipp
Keep your skill set small — every skill costs context tokens at load time

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: none
Datenabfluss: fetches only the skill repos you declare

Fehlerbehebung

Häufige Fehler und Lösungen

Flake doesn't evaluate

Check input url format and run nix flake check for specific errors.

Prüfen: nix flake check
Skills dir empty after switch

Make sure the module is actually imported in your HM config, and home.activation is running.

Prüfen: ls ~/.claude/skills/
Pinned rev 404

The upstream repo may have rewritten history — update the rev.

Alternativen

agent-skills-nix vs. andere

AlternativeWann stattdessenKompromiss
manual git cloneYou're not on Nix and don't want to beNo reproducibility; easy drift
agent-skills-cli-skillYou want a CLI installer without NixImperative rather than declarative

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen