claude-skills-map — ippoan/claude-skills 構造ナビゲーション¶
対象リポジトリ
- ippoan/claude-skills — 追従 tree
11d265f
検索トリガー語 (LLM 用)
ippoan/claude-skills (この repo 自身。Claude Code 共有 skill 集) の構造ナビゲーション。skill ディレクトリ群を「種別 (per-repo map / PR・CI 運用 / 構造把握メタ / secret・MCP / テスト・カバレッジ / freee・egov ドメイン / ブラウザ・ファイル・その他)」ごとにグループ索引化し、SKILL.md レイアウト規約・README 追記・scripts/.claude の位置を 1 枚にまとめる。トリガー:「claude-skills」「skill 一覧」「skill 追加」「どの skill」「SKILL.md 規約」「
ippoan プロジェクト共通の Claude Code skill 集 (この repo 自身)。各 skill は
<name>/SKILL.md ディレクトリ単位。この repo を project として開くと全 skill が /<name>
で使える。別 repo からは claude-hooks/session-start-install-skills.sh が symlink する。
ここは索引 (pointer)。個々の skill の使い方は各
SKILL.mdが正 (description は繰り返さない)。 frontmatter のgenerated-fromが現在の repo tree-sha とズレたら session-start hook が 再生成を促す → その時 tree-sha を更新する。新しい skill を追加したら本 map と README.md の両方を更新する (skill 追加 = tree-sha 変化 = 鮮度警告のトリガー)。
skill グループ (種別ごとの索引)¶
| グループ | 代表 skill | 役割 |
|---|---|---|
per-repo map (<repo>-map) |
auth-worker-map ci-dashboard-map rust-alc-api-map secrets-inventory(-gcp)-map release-wave-gcp-map ci-workflows-map freee-map HealthConnectReader(Worker)-map nuxt-*-map dtako-scraper-map 他多数 |
1 repo の構造ナビゲーション。frontmatter に generated-from: <repo>:<tree-sha> を持ち鮮度追跡される。新規は repo-map skill で作る |
| 構造把握メタ | repo-map cross-repo-symbol-index ippoan-infra-map large-codebase-setup |
per-repo map の作り方 / 横断 symbol 方針 / CCoW 基盤 5 repo 地図 / 大規模 codebase setup |
| PR / CI 運用 | pr-push pr-subscribe ci-init ci-cache-patterns tag-release branch-issue-linking auto-merge-401 gh-actions-phantom-permission check-issue |
PR 作成・購読 / CI bootstrap / release tag / 命名規約 / CI fail トラブルシュート |
| テスト / カバレッジ | nuxt-vitest worker-vitest coverage-check coverage-test-patterns migrate-test local-first-testing type-safe-pipeline verify-env |
各種テストハーネス / coverage gate / 型安全 pipeline / env 検証 |
| secret / MCP / package | secret-inject mcp-user-setup package-publish-debug npm-supply-chain |
no-leak secret 投入 / user-scope MCP attach / publish デバッグ / supply chain |
| ドメイン (freee / egov / gmail) | egov-api egov-spec gmail-mcp (freee 系は freee repo 同梱) |
e-Gov 電子申請 API / 仕様取得 / Gmail 閲覧・下書き (送信不可 MCP、ippoan/gmail-mcp) |
| ブラウザ / ファイル / 配信 | cdp-browser ui-preview ui-preview-map eml-read ref-files-bulk wrangler-logs |
CDP 操作 / UI preview 配信 / eml 解読 / ref-files 一括 DL / Workers ログ |
| worktree / open | worktree-cleanup wt-direct-push open-multirepo open-multirepo-smoke repo-migrate memory-prune |
worktree 掃除・直 push / multirepo 起動 URL / 移行 / memory 整理 |
完全な人間向け一覧と各 1 行説明は
README.mdの「スキル一覧」が正。本表はグループ索引。
区画 (top-level レイアウト)¶
| パス | 中身 |
|---|---|
<name>/SKILL.md |
旧来の top-level layout (引き続きサポート)。現状の skill の大半 |
.claude/skills/<name>/SKILL.md |
新しい skill の推奨パス。現状 gh-actions-phantom-permission gmail-mcp ippoan-infra-map large-codebase-setup local-first-testing open-multirepo ui-preview |
scripts/extract_symbol.py |
source から特定 symbol を抽出して context 節約 (Rust/Python/TS/Go/PHP)。cross-repo-symbol-index 系が使う |
README.md |
人間向け skill 一覧 + install 方法 (SessionStart hook / 手動) |
ルートの単独 *.md |
skill ではない note: backend-check.md bazel-rust.md compare-pdf.md smart-read.md |
entrypoint / 使い方¶
- 実行 entrypoint は無い (skill リポジトリ)。各 skill は Claude が
/<name>または description トリガーで起動する。 - 別 repo から使うには
claude-hooksのsession-start-install-skills.shを~/.claude/settings.jsonに登録 (=~/.claude/sources/に shallow clone → 各 SKILL.md を~/.claude/skills/<name>に symlink、冪等 TTL 1h)。
gotcha (README 由来)¶
- 新規 skill は
.claude/skills/<name>/SKILL.mdを使う (top-level は legacy)。 yhonda-ohishi/claude-skillsから移行した repo。secret 値や内部インフラ詳細を埋めていた skill (secrets.mdsupabase-r2incus-sandboxwt-quicksecret-rotate-pipedev-proxy-debug) は 移行時に意図的に除外。同種を再追加しない。- per-repo map を足したら README の「スキル一覧」にも 1 行追記する (この repo 自身の tree-sha が変わり、claude-skills-map の鮮度警告も出る)。
CCoW / CI から見た立ち位置¶
- CCoW container では
session-start-install-skills.sh(claude-hooks) がこの repo を clone して全 skill を配る。session-start-skill-coveragehook が「開いた repo に対応<repo>-mapskill が無い / 鮮度切れ」を検知してrepo-map起動を促す。 - skill の鮮度追跡は frontmatter の
generated-from: <repo>:<tree-sha>を SessionStart hook が tree-sha 比較する仕組み (cross-repo-symbol-indexskill に設計の結論)。
関連 skill¶
repo-map— per-repo map (<repo>-map) を新規作成 / 更新するメタ skill。本 repo の map 群の生成元cross-repo-symbol-index— map 鮮度 hook と横断 symbol 把握の方針 (保存せずその場 ctags)ippoan-infra-map— CCoW 基盤 5 repo の地図 (skill 配布元の claude-hooks を含む)memory-prune/skill-creator(外部) — skill 化 / 整理の運用
CLAUDE.md から移設 (2026-07-07)¶
スキルの置き場が 2 系統ある (重要)¶
スキルディレクトリは 2 箇所に割れている。install 時は どちらも
~/.claude/skills/ に symlink される (claude-hooks の
session-start-install-skills.sh) ので動作は同じ。人間が GitHub / ls で探す時
だけ注意 — repo トップだけ見ると .claude/skills/ 配下が見えず「無い」と錯覚する。
| 置き場 | スキル |
|---|---|
| repo 直下 (大多数) | auth-worker-map/, 各 <repo>-map/, repo-map/, cross-repo-symbol-index/, pr-push/, coverage-*, egov-*, open-multirepo-smoke/ … |
.claude/skills/ 配下 (少数) |
ippoan-infra-map, gh-actions-phantom-permission, gmail-mcp, large-codebase-setup, local-first-testing, open-multirepo, ui-preview, plan-with-fable, review-with-fable, plan-with-opus, review-with-opus |
この 2 系統への分裂は移行時の歴史的経緯で、統一方針は未確定。歴史的に直下が
多数派なので当面は直下に倣うのが無難 (Claude Code 標準パスは .claude/skills/ の方)。
新規追加時はこの不統一を意識する。
スキルの探し方¶
- 一覧:
README.mdの「スキル一覧」、またはls -d */ .claude/skills/*/ - キーワード検索:
grep -rl "キーワード" */SKILL.md .claude/skills/*/SKILL.md(各SKILL.mdの frontmatterdescription:にトリガー語が入っている)
まず読む map (infra / coverage 系を触る前に必読)¶
ippoan-infra-map(.claude/skills/ippoan-infra-map/) — CCoW 基盤 5 repo (claude-md / claude-hooks / mcp-relay-rs / cc-relay / mcp-cf-workers) の 「どのロジックがどの repo に居るか」 の SoT。判断軸: 動作 (script 実体) = claude-hooks / 配線 (登録・配置・env) = claude-md。cross-repo-symbol-index— 横断構造把握 + skill 鮮度 hook の設計 SoT。generated-from規約 / coverage・鮮度 hook = claude-hookssession-start-skill-coverage.sh/ claude-skills 自身は self-reference なので coverage 除外 (CLAUDE_SKILL_COVERAGE_IGNORE, claude-md の settings env) / 空 repo は empty-tree-sha placeholder で被覆。repo-map— 単一<repo>-mapを作る / 更新する手順 (ローカル ctags +generated-from: <repo>:<tree-sha>)。coverage hook が uncovered / stale を 警告した時に使う。
Fable plan/review 開発ループ¶
判断が効く「実装 plan」と「差分 review」だけを上位モデル Fable に切り出す skill 2 本
(/plan-with-fable / /review-with-fable、いずれも .claude/skills/ 配下) がある。
両者は共有エージェント .claude/agents/fable-advisor.md (model: fable、read-only)
を context: fork で起動する。前提条件・運用は README.md の
「Fable plan/review 開発ループ」を参照 (Refs #68)。
CLAUDE_CODE_SUBAGENT_MODEL を設定すると model: fable が上書きされ無効化される点に注意。
Sonnet→Opus 開発ループ (Fable 非アクセス環境向け代替)¶
Fable へのアクセスが無い環境向けに、同じ構成を Opus で再現した skill 2 本
(/plan-with-opus / /review-with-opus、いずれも .claude/skills/ 配下) がある。
共有エージェント .claude/agents/opus-advisor.md (model: opus、read-only) を
context: fork で起動する点・SKILL.md の構造は fable-advisor 版と完全に対称
(差分は model: フィールドのみ)。前提条件・Fable 版との使い分けは README.md の
「Sonnet→Opus 開発ループ」を参照。こちらも CLAUDE_CODE_SUBAGENT_MODEL 未設定が前提。