Claude Code プリビルトSkillとカスタムSkill 業務で使うときの選び方（要公式確認）

AnthropicがリリースしたClaude Codeは、単なるチャットAIではなく、開発者のローカル環境やリポジトリに深く入り込む「エージェント型CLI」です。その中核を成すのが「Skill（スキル）」という概念です。

実務において、「どこまでをClaude Codeの標準機能（プリビルト）に任せ、どこからを独自の実装（カスタム）で行うべきか」という判断は、生産性に直結します。本記事では、公式の仕様に基づき、Claude CodeのSkill選定基準と、リポジトリ上の CLAUDE.md や AGENTS.md を活用した高度な運用方法を解説します。

1. Claude Codeにおける「Skill」の本質

Claude Codeは、ターミナル上で動作し、ファイルシステムへのアクセスやコマンドの実行を自律的に行うことができます。これらの動作を支えるのが「Skill」です。

プリビルトSkill（標準搭載機能）

インストールした瞬間から Claude Code が利用できるツール群です。これらは Anthropic によって最適化されており、ユーザーが明示的に定義しなくても、AIが必要に応じて自動的に呼び出します。

• ls: ディレクトリ構造の把握
• grep / search: コードベース全体の検索
• read: ファイル内容の読み取り
• edit: ファイルの部分書き換え（diff形式）
• bash: 任意のコマンド実行

カスタムSkill（ユーザー定義）

標準機能だけでは対応できない、プロジェクト固有のルールや外部サービスとの連携を「教え込む」ことで実現する拡張機能です。具体的には、プロジェクトルートに配置する CLAUDE.md への記述や、自作のスクリプトを bash Skill経由で呼び出させる運用を指します。

2. プリビルトSkillで完結する業務の判断基準

多くの実務は、実はプリビルトSkillの組み合わせだけで十分に自動化可能です。以下のケースでは、カスタムSkillを構築するコストをかける必要はありません。

既存コードの調査とドキュメント生成

「このAPIのエンドポイントはどこで定義されているか？」「このコンポーネントの使い方は？」といった質問に対して、Claude Codeは自動的に grep や read を駆使して回答します。この際、リポジトリの全容を把握するために ls -R を裏側で実行することもあります。

テストコードの作成と実行

既存のテストファイルを読み取り、それを模倣した新しいテストケースを作成し、bash Skillで npm test や pytest を実行する。エラーが出れば、そのログを読み取って修正案を出す。これら一連の流れはプリビルトSkillの範疇です。

ただし、複数のSaaSが絡む複雑なデータ連携のテストなど、環境構築自体に特殊な手順が必要な場合は、次に述べるカスタムSkillの視点が必要になります。例えば、SaaSコストを削減するためにフロントオフィスツールを統合するような開発プロジェクトにおいて、複数のAPIキーを管理しながらテストを行う場合は、指示系統を整理しなければなりません。

3. カスタムSkillが必要になる「4つの境界線」

実務においてカスタムSkill（または CLAUDE.md による指示の拡張）が必要になるのは、以下の要件が発生した時です。

① 社内独自のCLIツールやCI/CDフローとの同期

一般的な git push だけでなく、社内独自のデプロイコマンドや、特定のセキュリティスキャンを通さなければならない場合、Claude Codeにその手順を「常識」として教える必要があります。

② 複雑なコンテキストの強制（AGENTS.md / CLAUDE.md）

Claude Codeは、プロジェクトルートにある CLAUDE.md を優先的に読み込みます。ここに「このプロジェクトでは必ずこの命名規則に従うこと」「プルリクエストを作成する前に必ずこのスクリプトを実行すること」と記述することで、AIの挙動をカスタマイズできます。これは実質的なカスタムSkillの定義といえます。

③ 外部SaaS・データベースとの高度な連携

リポジトリ内のコードを書き換えるだけでなく、BigQueryのデータを参照したり、Slackに特定のフォーマットで報告を上げたりする場合です。例えば、BigQueryと連携した行動トリガー型LINE配信のロジックを開発している場合、ローカルのClaude CodeからBigQueryのスキーマを確認しにいくカスタムスクリプトをSkillとして用意しておくと、開発効率が劇的に向上します。

④ 大規模な会計・基幹システム移行などの定型処理

ファイルフォーマットの変換（例：MJSからfreeeへの移行用CSV変換など）を大量に行う際、Claude Codeにその変換ロジックをスクリプトとして持たせ、「convert_mjs_to_freee という指示で実行せよ」と定義するのは非常に有効です。

4. 【比較表】プリビルトSkill vs カスタムSkill

どちらを採用すべきか、以下の比較表を参考にしてください。

5. 運用ガイド：CLAUDE.mdによるプロジェクトの最適化

実務担当者がまず着手すべきは、プログラムとしてのSkill開発ではなく、CLAUDE.md による「ふるまい」の定義です。これは、Claude Codeがプロジェクトを読み取る際の「憲法」になります。

CLAUDE.md の記述例

Project Rules

テストコマンド: npm run test:unit

Lint実行: npm run lint:fix

命名規則: キャメルケースを使用し、インターフェースには 'I' プレフィックスを付けないこと。

Custom Workflows

プルリクエスト作成前には必ず scripts/validate_schema.sh を実行し、その出力を確認すること。

データベース関連の修正を行う際は、docs/db_schema.md を必ず参照すること。

このように記述しておくことで、Claude Codeは bash プリビルトSkillを使って、指示されなくても scripts/validate_schema.sh を呼び出すようになります。これは、実質的にプロジェクト専用のカスタムSkillを実装したのと同等の効果を持ちます。

特に、経理の完全自動化（楽楽精算×freee連携など）を進めるプロジェクトでは、CSVの項目マッピングルールを CLAUDE.md に記載しておくことで、変換スクリプトの修正精度が飛躍的に高まります。

6. 実践：カスタムSkillを定義するステップ

高度な自動化を目指す場合、以下の手順でClaude Codeに「独自の能力」を与えます。

1. タスクのスクリプト化:
   まず、人間が叩いても動作するスクリプト（例：deploy_check.py）を作成し、リポジトリの scripts/ ディレクトリに配置します。
2. 実行権限とパスの確認:
   Claude Codeが bash 経由でそのスクリプトを叩けるよう、実行権限（chmod +x）を付与しておきます。
3. CLAUDE.mdへの登録:
   CLAUDE.md の中で、「〇〇をしたい時は、scripts/deploy_check.py を実行して結果を評価せよ」と明文化します。
4. 動作確認:
   Claude Codeに対して「デプロイ前のチェックをして」と自然言語で依頼します。AIがスクリプトを見つけ出し、実行し、その結果（標準出力）を解釈して次のアクション（修正や承認依頼）を提示すれば成功です。

7. セキュリティとコストの注意点

Claude CodeのSkill運用には、技術的な側面以外のリスク管理も欠かせません。

セキュリティ：破壊的コマンドの防止

Claude Codeは rm -rf / のようなコマンドも、ユーザーが許可（Approve）すれば実行できてしまいます。特にカスタムSkillで強力な権限を持つスクリプトを呼び出す場合は、実行前の確認フローを CLAUDE.md で重ねて強調しておく必要があります。

コスト：トークン消費の最適化

Skillの実行結果があまりに巨大なテキスト（数万行のログなど）を返す場合、それがそのまま Claude のコンテキスト（入力トークン）として消費されます。カスタムSkillを作成する際は、出力を要約したり、エラー箇所のみを抜粋して表示したりする工夫が必要です。

まとめ：どちらを選ぶべきか？

結論として、以下のような使い分けが最適です。

• まずは「プリビルトSkill + CLAUDE.md」で運用する: ほとんどのコーディング、テスト、リサーチ業務はこれで事足ります。
• 「特定のツール連携」が必要になったら「カスタムスクリプト + CLAUDE.md」へ移行する: 外部APIを叩く、特殊なビルドを通すといった、プロジェクト固有の「手作業」をスクリプト化し、それをClaude Codeに呼び出させます。

Claude Codeを「ただのチャット」として使うのではなく、リポジトリの一部としてSkillを構成・管理することで、開発チーム全体の生産性は異次元のレベルへと引き上げられます。公式ドキュメント（Anthropic公式の claude.ai 関連ドキュメント）を定期的に確認し、最新のプリビルトSkillの追加（MCPとの統合深化など）をチェックし続けることも忘れないでください。

3. **追記するHTMLだけ**（通常は `