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
どちらを採用すべきか、以下の比較表を参考にしてください。
| 比較項目 | プリビルトSkill (標準) | カスタムSkill (CLAUDE.md拡張等) |
|---|---|---|
| 導入コスト | ゼロ（即時利用可能） | 低〜中（スクリプト作成、指示定義が必要） |
| 柔軟性 | 汎用的な操作に限定 | 自社ルール、独自ツールに完全適合 |
| メンテナンス | Anthropicが自動更新 | 開発チームによる管理が必要 |
| 得意な作業 | コード読み書き、検索、一般コマンド実行 | 特定SaaS連携、規約チェック、一括変換 |
| セキュリティ | ユーザーの権限範囲内 | APIキー管理などの設計が必要 |
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に「独自の能力」を与えます。
- タスクのスクリプト化:
まず、人間が叩いても動作するスクリプト（例：deploy_check.py）を作成し、リポジトリのscripts/ディレクトリに配置します。 - 実行権限とパスの確認:
Claude Codeがbash経由でそのスクリプトを叩けるよう、実行権限（chmod +x）を付与しておきます。 - CLAUDE.mdへの登録:
CLAUDE.mdの中で、「〇〇をしたい時は、scripts/deploy_check.pyを実行して結果を評価せよ」と明文化します。 - 動作確認:
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との統合深化など）をチェックし続けることも忘れないでください。
7. 実務導入前に解消すべき「よくある誤解」
Claude Codeの導入検討において、特にエンジニアや情シス担当者が混同しやすいのが「MCP（Model Context Protocol）」との関係性です。Skillを自作すべきか、既存のMCPサーバーを利用すべきかの判断は、開発リソースの最適化に直結します。
MCPサーバーとカスタムSkillの違い
カスタムSkillが「特定リポジトリ内のローカルな自動化」に特化しているのに対し、MCPは「外部ツール（GitHub、Google Drive、Slack、データベース等）との標準化された接続」を担います。例えば、SaaSアカウント管理の自動化のように、組織横断的なツール連携が必要な場合は、個別のSkill定義よりもMCPサーバーの活用を優先すべきです。
「何でもできる」ゆえの権限管理
Claude Codeは、実行時に「Tenev（読み取り専用）」「Act（実行許可）」などのモードを選択しますが、実務では「どのディレクトリまでをAIの走査対象にするか」の設計が重要です。不要な設定ファイルや秘密情報を含むディレクトリを .gitignore や専用の拒否設定で保護しておくことが、セキュアな運用の前提となります。
8. 【チェックリスト】Skill実装・運用の判定基準
プロジェクトにClaude Codeを本格導入する際、プリビルトで進めるか、カスタムの定義（CLAUDE.md等）を作り込むかの判断基準を以下にまとめました。
| チェック項目 | プリビルト推奨（標準機能） | カスタム推奨（指示・Skill拡張） |
|---|---|---|
| ドキュメント参照 | リポジトリ内のREADME等の参照 | 社内WikiやNotion等、外部URLの常時参照 |
| コード品質担保 | 標準的なLint/Formatの実行 | 独自のアーキテクチャ規約への準拠確認 |
| データ連携 | ローカルファイルの加工・変換 | モダンデータスタック（BigQuery等）へのクエリ発行 |
| CI/CD | 一般的な git commit 操作 |
特定のデプロイメントパイプラインのトリガー |
9. 公式リソースでの最新仕様確認
Claude Codeは急速に進化しているツールです。特にベータ版の機能やコマンドの構文、MCPとの統合手順については、必ず以下の公式ドキュメントをベースに検証を行ってください。開発環境への導入手順や、Skillのより詳細な仕様が公開されています。
- Anthropic公式: Claude Code Documentation
[https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)
（※最新のプリビルトSkill一覧や、CLIのインストール要件を確認いただけます） - Anthropic公式: Model Context Protocol (MCP)
[https://mcp.io/](https://mcp.io/)
（※外部データソースとの連携を共通化するプロトコルの詳細仕様です）
特に、データ連携の全体設計を担う立場であれば、個別リポジトリのSkillを最適化する前に、MCPによるインターフェースの標準化が検討に値するかを公式ドキュメントで精査することをお勧めします。
ご相談・お問い合わせ
本記事の内容を自社の状況に当てはめたい場合や、導入・運用の設計を一緒に整理したい場合は、当社までお気軽にご相談ください。担当より折り返しご連絡いたします。