@pokkur/claude-kit

Agent Skills（SKILL.md）と rules をまとめてインストールできる npx ツールです。コミット支援・実装計画・画像処理・Unity・フロントエンドなど、汎用的に使える skill が揃っています。

• Claude Code と Codex に両対応 — 共通の SKILL.md フォーマットなので両方に設置できます
• 必要な分だけ選んで導入 — 対話式チェックボックス、または --group で部分インストール
• 日本語 / 英語を選択可能 — --en で英語版を設置（既定は日本語）

クイックスタート

npx @pokkur/claude-kit

引数なしで実行すると、まずインストール先スコープを選び、続いて対話式チェックボックスでグループを選べます。終わったら Claude Code（Codex 併用時は Codex も）を再起動してください。

インストール先スコープ: ↑↓=移動 / Enter=確定 / q=中止

❯ (●) ユーザースコープ — ~/.claude（全プロジェクト共通）
  ( ) プロジェクトスコープ — ./.claude（skill のみ。rules は対象外）

スペース=選択 / ↑↓=移動 / a=全切替 / Enter=確定 / q=中止

❯ [x] core (8)
  [x] frontend (5)
      [x] react (1)
      [x] vue (1)
  [x] unity (3)

CI など非 TTY 環境ではプロンプトを出さず、ユーザースコープへすべてインストールします。

何が入るか

インストール後は /pk-commit のようにスラッシュコマンドとして呼べるほか、description に合致する場面では Claude / Codex が自動で参照します。

core — 開発サイクルを回す汎用 skill

「次にやることを決める → 計画を立てる → 記録する → 安全にコミットする」という日常の開発ループを支える skill 群です。

| skill | 何をしてくれるか | |-------|------| | pk-go-next | 次の作業課題を提案し、計画書生成 → ブランチ作成 → 作業開始までつなげる | | pk-impl-plan | 実装計画書を docs/plans/YYYY/MM/ に生成し、完了後は resolved/ へ整理 | | pk-commit | 作業ディレクトリの全変更を精査し、コミット規約に従って安全にコミット | | pk-journal | 開発日誌を自動生成・管理（日付間違い防止付き） | | pk-create-local-issue | GitHub Issues を使わないプロジェクト向けの docs/issues/ ローカル Issue 管理 | | pk-image-magick | ImageMagick 7 で画像のトリミング・リサイズ・連結・変換（サイズ違い結合も対応） | | pk-settings-tidy | Claude Code の settings.json の permissions を監査・整理（重複・タイポ・危険コマンド検出。Claude Code 専用） | | pk-ntfy | 長時間タスクの完了・確認依頼を ntfy でスマホ等へプッシュ通知 |

frontend — Web フロントの診断と品質

| skill | 何をしてくれるか | |-------|------| | pk-ts-fix | TypeScript/ESLint エラーをサブエージェント並列スウォームで自動修正（Claude Code 専用） | | pk-anim12-ui | ディズニー 12 原則で UI アニメーションを生成・レビュー（CSS / Framer Motion / GSAP 等） | | pk-button-label-check | ボタン・CTA ラベルを UI テキストガイドラインに照らして検証 | | react/pk-react-doctor | React コードベースを診断し 0-100 のヘルススコアで評価。修正依頼時は再診断ループで収束まで直す | | vue/pk-vue-doctor | Vue / Nuxt を vue-mess-detector で静的解析し健康度を診断。修正依頼時は再解析ループで収束まで直す |

unity — Unity Editor 操作とゲームモーション

| skill | 何をしてくれるか | |-------|------| | pk-unity-uloop-operator | uloop CLI 経由で Unity Editor を操作（GameObject 生成・テスト実行・PlayMode 自動化） | | pk-unity-probuilder | ジオメトリ生成で ProBuilder と標準プリミティブを用途別に使い分け | | pk-anim12-tween | ディズニー 12 原則を DOTween / Animator / Timeline のモーションに適用 |

親グループを指定すると子（frontend → react / vue）も含まれます。最新の一覧は npx @pokkur/claude-kit --list で確認できます。

インストール先（ユーザースコープ・既定）:

• ~/.claude/skills/<name>/ — Skills（/pk-commit などスラッシュコマンドとして利用可能）
• ~/.claude/rules/pk/*.md — 言語・フレームワーク別ルール
• ~/.claude/agents/pk-*.md — skill が依存するサブエージェント定義（例: pk-ts-fix 選択時の pk-type-fixer。Claude Code 専用）
• --codex 指定時は ~/.codex/skills/ にも設置

プロジェクトスコープ（対話プロンプトまたは --scope project）を選ぶと、カレントディレクトリの ./.claude/skills/<name>/ に設置され、そのプロジェクトでのみ有効になります。rules はマシン全体の設定（~/.claude/CLAUDE.md への配線）を前提とするためユーザースコープ専用で、--codex もプロジェクトスコープでは使えません。

既存の同名エントリがある場合、対話実行（TTY）ではその場で上書き確認プロンプトが出ます（上書き時は backups/ へ退避してから）。claude-kit が設置した記録のないエントリは別ツール・自作の可能性があるため、別枠で確認します。CI など非 TTY では黙ってスキップし、--force（+ 素性不明エントリは --adopt-conflicts）で上書きを指定できます。skill 名は他ツールとの衝突を避けるため pk- プレフィックス付きです。

よく使うオプション

npx @pokkur/claude-kit --group unity                    # Unity 系だけ
npx @pokkur/claude-kit --only pk-commit,pk-impl-plan    # 個別 skill だけ
npx @pokkur/claude-kit --scope project --group unity    # このプロジェクトの .claude/ に設置
npx @pokkur/claude-kit --codex                          # Codex にも設置
npx @pokkur/claude-kit --en                             # 英語版を設置
npx @pokkur/claude-kit --dry-run                        # 書き込まずに確認
npx @pokkur/claude-kit --help                           # 全オプションを表示

| オプション | 説明 | |---|---| | --group <names> / --only <names> | グループ / skill 名で選択（カンマ区切り） | | --all | 対話プロンプトを出さず全部 | | --ja / --en | skill 本文の言語（既定 ja。英語版が無いものは日本語にフォールバック） | | --scope <user\|project> | 設置先スコープ（既定 user = ~/.claude。project = ./.claude、skill のみ） | | --codex | ~/.codex/skills にも設置（ユーザースコープのみ） | | --force | 既存エントリを上書き（バックアップを取ってから）。非 TTY 実行用で、TTY では対話で確認 | | --skip-rules | rules をインストールしない | | --dry-run / --list | インストール予定を確認して終了 |

その他のインストール経路

npx インストーラのほかに、次の 2 経路でも導入できます（いずれも skills のみ。rules・所有権マニフェスト・言語選択は npx インストーラ専用の機能です）。

Claude Code プラグインとして

/plugin marketplace add pokkur/claude-kit
/plugin install pk-core@claude-kit        # ほかに pk-frontend / pk-unity

マーケットプレイス定義（.claude-plugin/marketplace.json）はグループ単位の 3 プラグイン構成です。

npx skills（汎用 skill インストーラ）から

npx skills add pokkur/claude-kit

vercel-labs/skills 経由で、Claude Code / Codex / Cursor / Gemini CLI など 70 以上のエージェントに設置できます。

rules について

rules は ~/.claude/rules/pk/*.md に置かれ、あわせて ~/.claude/CLAUDE.md へ参照ブロックを自動追記して有効化されます（マーカーで囲まれた領域だけを更新するので他の内容には影響しません。べき等）。自動追記が不要なら --skip-rules-wiring、rules 自体が不要なら --skip-rules を指定してください。

License

MIT