/ ディレクトリ / プレイグラウンド / agent-skills-nix
● コミュニティ Kyure-A ⚡ 即起動

agent-skills-nix

作者 Kyure-A · Kyure-A/agent-skills-nix

Nixを使ってClaude Agentスキルを宣言的に管理 — マシン間で再現可能なスキルセットを実現します。

NixフレークでAgentスキルをNixコンフィグに宣言し、~/.claude/skills/(または任意のターゲット)に展開できるようにするツールです。NixOSやHome Managerを既にお使いの方が、スキル設定をドットファイルと同様に再現可能にしたい場合に便利です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

agent-skills-nix-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/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
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.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 は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

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
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"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
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.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 はマップではなくサーバーオブジェクトの配列を使用。

~/.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"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

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

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: agent-skills-nix

NixフレークでClaudeスキルを宣言する方法

👤 NixOS / Home Managerユーザー ⏱ ~25 min intermediate

使うタイミング: Claudeのスキルセットをシェル、エディタ、サービスと同じ方法で管理したいとき。

前提条件
  • フレークが有効なNix — echo 'experimental-features = nix-command flakes' >> ~/.config/nix/nix.conf
  • フレークをインプットとして追加 — flake input agent-skills-nix.url = "github:Kyure-A/agent-skills-nix";
フロー
  1. インプットを追加する
    agent-skills-nixをフレークのインプットに追加し、Home Managerに接続してください。✓ コピーしました
    → flake.nixにインプットとモジュールインポートが追加される
  2. 使いたいスキルを指定する
    使用するスキルを宣言してください: linear-claude-skill, symfony-ux-skills, mck-ppt-design-skill。現在のmainに固定。✓ コピーしました
    → 固定リビジョン付きのskills = { ... };ブロック
  3. ビルドして切り替える
    home-manager switchを実行し、~/.claude/skills/にスキルが展開されていることを確認してください。✓ コピーしました
    → すべてのスキルがシンボリックリンクされたディレクトリとして存在する

結果: Nixで管理される再現可能なスキルセット — ドットファイルを消しても、コマンド一つで同じ環境を復元できます。

注意点
  • アップストリームのスキル変更がワークフローを壊す — 特定のリビジョンに固定し、意図的にのみ更新する
組み合わせ: filesystem

ノートPCとワークステーションで同じスキルセットを同期する

👤 複数マシンを使う開発者 ⏱ ~15 min intermediate

使うタイミング: ノートPCとデスクトップを行き来しており、同じスキルのクローンを忘れがちなとき。

フロー
  1. 共有HMモジュールに追加する
    スキル宣言を共有のhome-managerモジュールに移動し、両方のホストでインポートするようにしてください。✓ コピーしました
    → 単一の信頼できるソースを2つのホストが参照する構成
  2. 両方のホストで切り替える
    両方のマシンでビルドして切り替えてください。✓ コピーしました
    → 両方で~/.claude/skills/の内容が一致する

結果: 両方のマシンが同じスキルバンドルを自動的に保持します。

注意点
  • 2台目で切り替える前にコミットとプッシュを忘れる — autoCommit付きのself-flakeまたは共有gitリポジトリを使用する

組み合わせ

他のMCPと組み合わせて10倍の力を

agent-skills-nix-skill + filesystem

Claudeがフレークを読み取り、追加・削除すべきスキルを提案する

flake.nixを読み取り、インストール済みスキルのうち30日間使用されていないものを確認し、削除を提案してください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
skill-declaration set of { name, url, rev } home-manager switch / nixos-rebuildの実行時 nix build runtime
lock-management flake.lock 決定論的なアップグレードを行いたいとき 0

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
最小限 — Nix宣言は短いため
金額
無料
ヒント
スキルセットは小さく保つこと — スキルごとにロード時のコンテキストトークンを消費します

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: なし
データ送信先: 宣言したスキルリポジトリのみをフェッチします

トラブルシューティング

よくあるエラーと対処法

フレークが評価されない

インプットのURL形式を確認し、nix flake checkを実行して具体的なエラーを確認してください。

確認: nix flake check
切り替え後にスキルディレクトリが空

モジュールがHMコンフィグで実際にインポートされているか、home.activationが実行されているか確認してください。

確認: ls ~/.claude/skills/
固定リビジョンが404

アップストリームリポジトリが履歴を書き換えた可能性があります — リビジョンを更新してください。

代替案

agent-skills-nix 他との比較

代替案代わりに使う場面トレードオフ
manual git cloneNixを使っておらず、使う予定もないとき再現性なし、環境の差異が生じやすい
agent-skills-cli-skillNixなしでインストーラーを使いたいとき宣言的ではなく命令的な管理

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る