@pokkur/claude-kit

Personal Agent Skills (SKILL.md) & rules installer for Claude Code and Codex — grouped, selectable skills with Japanese/English overlays, installed into ~/.claude (and optionally ~/.codex)


Keywords
claude-code, codex, agent-skills, skills, skill.md, unity, react, vue, dotfiles
License
MIT
Install
npm install @pokkur/claude-kit@0.1.1

Documentation

@pokkur/claude-kit

node license

Claude Code Codex skills

skills.sh

Agent SkillsSKILL.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 のモーションに適用

親グループを指定すると子(frontendreact / 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 = ~/.claudeproject = ./.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