エージェントスキル([[T0]を含むディレクトリ)をNixで宣言的に管理します。 ピン スキル ソース, 必要なスキルを選択し、ホームを介してそれらをインストールします。 マネージャーまたは project-local コマンド 選択したスキルをエクスポートすることもできます。 自己完結型 Agent プラグイン。

デフォルトでは何もインストールされていません。スキルとターゲットの両方を明示的に選択します。

##ホームマネージャーのクイックスタート

既存の flake ベースの Home Manager 構成では、これらの入力を あなたの薄片:

[outputs = inputs@{ ... }: ...;] でフレーク入力をキャプチャします。 追加する [inputs.agent-skills.homeManagerModules.default]を既存のホームマネージャーに [modules] リストとパス [extraSpecialArgs = { inherit inputs; };] [home-manager.lib.homeManagerConfiguration]。 これは、名前付けされたスキルの入力を作ります モジュールに利用できます。

次に、ホームマネージャーの構成に以下を追加します。

いつも通りホームマネージャーの設定を行います。 選択したスキルが同期されます [${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills へ。 他のエージェントを有効にする [targets. .enable = true;; デフォルトターゲットパスを参照してください。 既存の非空のスキルディレクトリについては、 目的地の所有権。

完全なクイックスタートの例は両方を示しています 入力を整理する方法:

agent-skills-nix

Manage Agent Skills (directories containing SKILL.md) declaratively with Nix. Pin skill sources, select the skills you need, and install them through Home Manager or project-local commands. You can also export selected skills as a self-contained Agent Plugin.

Nothing is installed by default: choose both skills and targets explicitly.

Quick start with Home Manager

For an existing flake-based Home Manager configuration, add these inputs to your flake:

inputs = {
  agent-skills.url = "github:Kyure-A/agent-skills-nix";
  anthropic-skills = {
    url = "github:anthropics/skills";
    flake = false;
  };
};

Capture the flake inputs with outputs = inputs@{ ... }: ...;. Add inputs.agent-skills.homeManagerModules.default to your existing Home Manager modules list and pass extraSpecialArgs = { inherit inputs; }; to home-manager.lib.homeManagerConfiguration. This makes the named skill input available to the module.

Then add the following to your Home Manager configuration:

programs.agent-skills = {
  enable = true;

  sources.anthropic = {
    input = "anthropic-skills";
    subdir = "skills";
  };

  skills.enable = [ "frontend-design" "skill-creator" ];
  targets.claude.enable = true;
};

Apply your Home Manager configuration as usual. The selected skills are synced to ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills. Enable other agents with targets..enable = true;; see default target paths. For an existing non-empty skills directory, see destination ownership.

The complete quickstart examples show both ways to arrange the inputs:

• Main flake: keep agent-skills and skill sources alongside your Home Manager inputs.
• Child flake: keep the skill inputs in a separate catalog flake.

How it works

1. Sources point to skill roots in flake inputs, local paths, or an optional source registry.
2. Discovery scans for SKILL.md files and builds a catalog. Nested skill IDs use /, such as documents/pdf; idPrefix adds a source namespace.
3. Selection chooses catalog entries with skills.enable or skills.enableAll, and custom declarations with skills.explicit.
4. Bundling builds the selection in the Nix store, including any content transforms and package dependencies.
5. Targets install the bundle for enabled agents. Explicit skills can limit installation to named targets with agents.

Guides and examples