nix-skills

skills

AI エージェント(Claude Code / Codex)向けスキルを管理するリポジトリ。 各スキルは agentskills.io のオープン標準に従い、 カテゴリごとに独立した Claude Code プラグインとして、1 つのマーケットプレイスから 個別に install できる。

スキルは 3 つのレイヤーを併用している。加えて Claude Code 限定で、 スキルに紐づくサブエージェントと運用 hook も plugin として同梱する:

レイヤー	担当	実体
スキルの中身	agentskills.io 標準	skills/<category>/<skill-name>/SKILL.md(frontmatter)+ references/ 等
配布・パッケージング	Claude Code plugin	per-category skills/<category>/.claude-plugin/plugin.json + .claude-plugin/marketplace.json
Codex 連携	本リポジトリの慣習	per-skill agents/openai.yaml
サブエージェント(任意)	Claude Code plugin	per-skill agents/<name>.md
運用 hook	Claude Code plugin	汎用: hooks/hooks.json / skill 連動: skills/<category>/hooks/hooks.json

ディレクトリ構成

.
├── .claude-plugin/
│   └── marketplace.json              # マーケットプレイス定義(6 プラグインを列挙)
│                                     #   + リポジトリ直下の .claude-plugin/plugin.json は
│                                     #     yasunori0418-hooks プラグイン (source: "./")
├── flake.nix                         # 成果物 + treefmt(formatter) + checks(検証)
├── dev/flake.nix                     # 開発用 devShell (default / ci)
├── pkgs/
│   └── skills-ref.nix                # 公式 skills-ref validator の Nix ビルド式(callPackage)
├── schema/
│   └── openai-agent.schema.json      # agents/openai.yaml の JSON Schema
├── scripts/
│   └── validate-skills.sh            # 全スキルの検証 (nix flake check / CI から呼ばれる)
├── hooks/                            # yasunori0418-hooks プラグイン (source: "./", skill 非依存)
│   ├── hooks.json                    # plugin hooks 定義(PreToolUse guard・通知等)
│   └── <name>/main.sh + tests/       # 各 hook の実体 (checks.hooks で実行)
└── skills/
    └── <category>/                   # 各カテゴリ = 独立プラグイン (source: "./skills/<category>")
        ├── .claude-plugin/plugin.json  # プラグイン定義(name: <category>-skills / skills 配列)
        ├── hooks/                      # 任意: skill 連動 hook (例: git/hooks/git-guard)
        │   ├── hooks.json
        │   └── <name>/main.sh + tests/
        └── <skill-name>/               # 各スキル(agentskills.io 標準)
            ├── SKILL.md                # 必須: frontmatter (name/description …) + 本文
            ├── README.md               # 人間向け説明
            ├── agents/openai.yaml      # 任意: Codex(OpenAI) 連携
            ├── agents/<name>.md        # 任意: Claude Code ワーカーサブエージェント
            ├── references/             # 任意: 必要時に読む詳細資料
            ├── scripts/                # 任意: 実行可能スクリプト
            └── assets/                 # 任意: テンプレ・画像など

スキルは skills/<category>/<skill-name>/ 形式でカテゴリ配下に置く。 SKILL.md の name は 親ディレクトリ名と一致させること。

Claude Code プラグインとして使う

1 マーケットプレイス(marketplace.json)に 6 つのプラグインを列挙している。 利用者は必要なカテゴリだけを選んで install できる。

プラグイン	source	内容
git-skills	./skills/git	commit-flow / diff-review / rebase-flow / reset-flow / parallel-worktree + git-guard hook
github-skills	./skills/github	gh-ci-investigate / gh-fetch / gh-push / pr-create
nix-skills	./skills/nix	nix-cache-check / nix-devenv
claude-skills	./skills/claude	external-writes / latency-triage / response-format / session-insights / test-targeted / tmp-output
product-skills	./skills/product	biz-translate / product-spec
yasunori0418-hooks	./	skill 非依存の guard/通知 hook(AskUserQuestion 無効化・通知、WebFetch の gh 誘導、sudo 禁止、Stop 通知)

hook の分離方針: git rebase/reset をスキル経由へ強制する git-guard は、 rebase-flow/reset-flow スキルとペアで機能するため git-skills プラグインに同梱する。 それ以外の skill 非依存 hook は yasunori0418-hooks にまとめ、独立して install できる。

ローカルパス運用(推奨): 手元の checkout を marketplace として登録すると、 push せずにローカル編集を配信できる。marketplace add は 1 回、install は欲しい カテゴリごとに行う。

/plugin marketplace add ~/src/github.com/yasunori0418/skills
/plugin install git-skills@yasunori0418-skills
/plugin install github-skills@yasunori0418-skills
/plugin install yasunori0418-hooks@yasunori0418-skills

編集の反映手順(実測): plugin はキャッシュ (~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/)への version 単位のコピーで ロードされるため、symlink 時代のような即時反映はされない。ローカル編集を反映するには