learning-skills

skills

AI エージェント(Claude Code)向けスキルを管理するリポジトリ。 各スキルは 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	skill 非依存: hook 単位プラグイン hooks/<plugin>/hooks/hooks.json / skill 連動: skills/<category>/hooks/hooks.json

ディレクトリ構成

.
├── .claude-plugin/
│   └── marketplace.json              # マーケットプレイス定義(12 プラグインを列挙)
├── 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/                            # skill 非依存 hook = hook 単位の独立プラグイン
│   └── <plugin>/                     # 各 hook プラグイン root (source: "./hooks/<plugin>")
│       ├── .claude-plugin/plugin.json  # プラグイン定義(name: yasunori0418-<hook名>-hooks)
│       ├── hooks/hooks.json          # plugin hooks 定義(PreToolUse guard・通知等)
│       └── hooks/<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)に 12 のプラグイン(カテゴリ 8 + hook 4)を 列挙している。利用者は必要なカテゴリ・hook だけを選んで install できる。