Claude Code Skills おすすめ：開発者必携の 10 Skill Framework

1. なぜ Claude Code Skills が必要か？

Claude Code はターミナル上の Agent だ。リポジトリを読み、shell を実行し、ファイルを書き換える。弱点もはっきりしている——セッションごとに記憶はリセットされ、チーム規約を毎回プロンプトに貼り直さない限り再現性がない。Skills はこれを解く。「いつ・どう・どのツールで・どんな形式で出力するか」を SKILL.md に書き、関連するときに Claude が自動読み込みするか、/skill-name で手動トリガーする。

AI 支援リポジトリにメンバーを迎え入れた経験があれば、パターンは見えている。1 週目は「PR レビューの前に何を貼ればいい？」、3 週目は Slack から誰かのプロンプトをコピー、6 週目は誰かがプロンプトを「直して」リリースチェックリストが抜ける——Skills はその知識をチャット履歴からファイルに移し、diff・review・revert できるようにする。

旧来の .claude/commands/*.md と比べ、Skills は Agent Skills オープン標準 に準拠し、allowed-tools による権限制限、disable-model-invocation による誤発火防止、サブ Agent 実行などの拡張をサポートする。公式ドキュメント：Claude Code Skills。

Hashvps 読者にとっての実用価値はもう一段ある。Xcode 署名、Fastlane、CI プローブをプロジェクト Skill として書けば、同じ Runbook がローカル Mac とクラウド Mac mini 開発ノードの両方で動く——マシンを替えても AI を再教育する必要がない。Claude Code が広い Agent ランドスケープのどこに位置するかは、リモート算力と個人 AI Agent クラスター最適化の文脈とも重なる。

2. Skills はどう分類するか？（What）

「どの 10 個を入れるか」の前に、3 層を切り分ける。

2.1 内蔵 Skill（すぐ使える）

Anthropic が /code-review、/debug、/batch、/loop、/claude-api などを同梱。セッションごとに利用可能で、ディレクトリ作成不要。個人が Agent の挙動を素早く検証するのに向く。内蔵 Skill はリファレンス実装として読む——ステップ構成、前提コンテキスト、呼び出すツールを把握してからカスタム Skill を書く。

2.2 プロジェクト級 Skill（.claude/skills/）

リポジトリと一緒に移動し、Git にコミット必須。チームの PR 規約、リリースチェックリスト、セキュリティ監査テンプレートに最適。git clone 後に /skills を実行すれば同じプレイブックが見える。社内サービス名、必須 JIRA プレフィックス、ASC バンドル ID 規約など、会社固有の言語はここに書く。

2.3 個人級 Skill（~/.claude/skills/）

プロジェクト横断の習慣——コミットメッセージの文体、メモ整理、個人向けリサーチ要約など。リポジトリに縛られず、チーム PR なしで素早く反復できる。3 つのリポジトリで同じ Skill が必要になったら、プロジェクト級に昇格させる。

多くのチームが陥るのは、パスが楽だから個人級から始めること。ベストエンジニアが去るとワークフローの半分が消える。プロジェクト級 Skill は、毎回の standup をプロンプト療法にしないための制度化だ。

3. 必携 10 Skill の比較（How Compare）

下表は「ツール × 入口 × 実行 × コンテキスト × 対象者」で統一。内蔵 2 個 + 自作推奨 8 個（名前は任意、ロジックは維持）。名前を変える前に、週次で繰り返しているタスクにマッピングする——直近 3 回いつ必要だったか言えなければ、それは Skill ではなく願望リストだ。

code-review と debug が入口。commit と test-runner が次の転換点——Agent を検証可能な成果物（Git 履歴、テスト出力）にアンカーする。xcode-release と ci-fix は macOS 実行が必須——Skill 本文を書く前にホストを決める。

3.1 内蔵 vs カスタム：早見表

iOS の収益検証では xcode-release をビジネス Skill と重ねる——Claude Code で iOS アプリを作って稼ぐ：7 日間検証チェックリストを参照。

4. シナリオ別の選び方：決定マトリクス

下表はインストール順の目安であり、買い物リストではない。Skill 追加のたびに /skills を実行し、自動トリガーが多すぎるか足りないかを観察する——description の調整はロールアウトの一部だ。

5. おすすめの組み合わせ（Stack）

スタックは意図的な重ね合わせだ。1 つで review 品質、もう 1 つでコミット規律、3 つ目で正しい OS 上の実行。10 個を初日に全部入れない——1 スタックを 2 週間使い、同じ指示を打ち直している自分を捕まえたときだけ次の Skill を追加する。

組み合わせ A — 最小構成（1 日）

• 内蔵 /code-review + カスタム commit（description + 本文 5 行で十分）
• ターミナルで Claude Code を常駐、編集直後に review
• 成功指標：PR コメントが減り、チェックリストが一貫する

組み合わせ B — iOS リリーススタック

• xcode-release（手動）+ test-runner（Swift 変更後に自動）
• 実行ノード：ローカル M4 または Hashvps クラウド Mac——Windows/Linux では Archive 不可
• 成功指標：Archive + アップロードがノート PC とリモートノードで同じ Skill によりヘッドレス完了

組み合わせ C — チーム規約スタック

• プロジェクト級 security-review + docs-sync + ci-fix
• PR テンプレに「マージ前に /security-review を実行」と明記
• 成功指標：新規コントリビュータが秘密のプロンプトを聞かずに review を通過

組み合わせ D — Skill 工場

• 個人級 create-skill——3 回目に繰り返した手動プロンプトは Skill 化
• 四半期ごとに /skills 整理：30 日未使用は削除
• 成功指標：リポジトリ複雑度が上がっても Skill 数は横ばい

6. よくある誤解

Skill 失敗の多くは「モデルが鈍くなった」ように見えて、実際は description の重複、ツール制限の欠如、macOS 専用ステップを間違ったホストで走らせていることが原因だ。11 個目を追加する前にこのリストを確認する。

• 「Skill は多いほど良い」 → description が互いにトリガーを奪い合いコンテキストが膨張；10 個以内で境界が明確な方が安定。
• 「本文が長いほど強い」 → メイン SKILL.md は約 500 行以内、詳細は references/ へ。
• 「個人ディレクトリだけでチーム運用できる」 → チーム規約は .claude/skills/ + Git へ。
• 「全部自動トリガーが正義」 → リリース、削除、本番設定変更は disable-model-invocation: true。
• 「Skill は CI の代わり」 → Skill は開発時アシスト；ゲートは GitHub Actions / Xcode Cloud にハードコード。
• 「Mac なしで xcode-release」 → Archive と codesign は macOS 必須——ローカルまたはクラウド Mac ノード。
• 「ブログの Skill を description 無編集でコピー」 → 汎用 description は自動トリガーされない；自リポジトリのファイル種別とコマンドに書き換える。

7. 七ステップ：今日から Skills を入れる

週末ハッカソンではなく 1 週間のロールアウトとして扱う。1 日目は内蔵のみ。3 日目に繰り返しタスクから最初のカスタム Skill。7 日目に Apple プラットフォームビルドなら macOS 実行をバインドする。

1. Claude Code をアップグレード——2026 年 Agent Skills 対応ビルドに。ターミナルで claude doctor を実行し、CLI・認証の問題を先に解く。
2. 繰り返しを列挙：先週、同じ review チェックリストを 3 回打った？ → Skill 候補。3 回見つからなければカスタム Skill の時期ではない。
3. ディレクトリ作成：mkdir -p .claude/skills/commit/SKILL.md（プロジェクト）または ~/.claude/skills/（個人）。1 Skill 1 フォルダ。
4. frontmatter 記述：description に動詞 + シーン；高リスクは disable-model-invocation: true。トリガー文言を言い換えてマッチするかテストする。
5. 検証：/skills で一覧確認；実タスクで自動トリガーと手動 /name を試す。誤発火と未発火を別々に記録。
6. Git コミット：プロジェクト Skill はコードと同じ PR に。reviewer も Skill 変更を審査。5 分で読めるサイズに。
7. 実行ノード接続：Xcode / launchd を含む Skill は macOS ホスト（ローカルまたはクラウド Mac）にバインド。SSH 接続後も同じ /xcode-release。README にホストを明記し、CI と人間が同じノードを使う。

mkdir -p .claude/skills/commit
cat > .claude/skills/commit/SKILL.md <<'EOF'
---
description: Write Conventional Commits message from staged git diff. Use when user asks to commit or /commit.
allowed-tools: Bash, Read
---
# Commit Skill
1. Run `git diff --staged`
2. Output subject <= 72 chars, body with bullet points if needed
3. Do not commit until user confirms
EOF
claude
/skills

8. まとめ

2026 年の Claude Code Skills の本質は、「ベテランエンジニアの頭の中のチェックリスト」を、バージョン管理・共有可能・権限制限付きの Skill Framework にすることだ。まず code-review、debug、commit、security-review、test-runner の 5 つを土台にし、スタックに応じて xcode-release、ci-fix、docs-sync、refactor-plan、create-skill を重ねる。

高額サブスクと最初のプロジェクト Skill のどちらを先にするか迷ったら、Skill を選ぶ。サブスクはトークン単価が変わる；Skill は自分が何度同じことを言うかを変える。モデルは平凡でも Skill が優秀なチームの方が、最先端モデルと場当たりプロンプトのチームより予測可能に出荷できる。

非対称な結論を忘れないでほしい：分水嶺はモデルスコアではなく、ワークフローの入口と実行境界だ。 高いサブスクを議論する前に、まず SKILL.md に焼き込む。

関連リンク：Claude Code Skills 公式ドキュメント · Anthropic 料金