Claudeでカスタムスキルを作成する方法：ステップバイステップガイド

AIモデルがますます強力になる中、チームは特定のワークフローを効率的に実行する方法を模索しています。Claudeはデータのレビュー、コードチェック、レポート作成、プレゼンテーション準備などが可能ですが、毎回同じ構造、検証ルール、企業標準、最終チェック指示を繰り返す非効率に直面していました。この反復は時間を浪費し、結果の一貫性を損ないます。

Claudeのカスタムスキル（Custom Skills）は、この問題を解決するために設計されました。再利用可能な指示、ワークフロー、テンプレート、スクリプト、例、参照ファイルをパッケージ化し、該当タスクにClaudeが自動でロードします。本記事では、Claudeスキルの仕組み、設定オプションを詳しく解説し、実践的なCSVデータ監査スキルを段階的に構築します。

カスタムスキルとは？

スキルはディレクトリです。Claudeが特定のタスクを完了するための指示と、オプションのリソースを含みます。必須ファイルはSKILL.mdのみで、スキルの機能、使用タイミング、手順を定義します。アウトプットフォーマットの指定や、スクリプト、テンプレート、例、参照ファイルへのポインタも可能です。

スキルはAgent Skillsオープン標準（agentskills.io）に従い、コア部分（名前、説明、プレーンMarkdown）はClaudeアプリ、Claude Code、Claude Agent SDK、Claude Developer Platform間で移植可能です。各製品が独自の機能を拡張するため、混乱の原因となっています。

スキルとカスタムコマンドの統合

Claude Codeを使用していた場合、.claude/commands/ディレクトリにファイルが存在するかもしれません。カスタムコマンドはスキルに統合されました。.claude/commands/deploy.mdと.claude/skills/deploy/SKILL.mdはどちらも/deployコマンドを作成し、同じ動作をします。既存のコマンドファイルは引き続き機能し、スキルはオプション機能（サポートファイル用ディレクトリ、呼び出し制御のフロントマター、タスク関連時の自動ロード）を追加します。同名の場合、スキルが優先されます。

プログラミングは必要？

いいえ。基本的なカスタムスキルはMarkdownのみで作成できます。例えば、以下は完全に動作するスキルです。

---
name: code-review-python
---

Review Python code for best practices, type hints, and PEP 8 compliance.

コードが必要になるのは、データ分析、ファイル処理、出力検証、可視化生成、構造化情報変換、コマンドラインユーティリティ呼び出し、決定論的計算、ドキュメント作成・修正、開発ワークフロー自動化などの場合です。シンプルなルール：指示のみのワークフローにはコード不要、決定論的処理や自動化にはコードが有効、外部システム統合には通常ツール・スクリプト・MCPが必要。Markdownから始め、指示だけでは信頼できる実行ができない場合にコードを追加します。

スキルの動作仕組み

スキルはプログレッシブディスクロージャーを採用し、全てのスキルとファイルを一度にコンテキストウィンドウにロードしません。段階的に情報を読み込みます。

• ステージ1：発見：起動時に、Claudeは各スキルのメタデータ（名前と説明）のみを読み込み、リクエストに一致するか判断します。
• ステージ2：指示ロード：スキルが関連と判断されると、SKILL.mdのMarkdown本文をロードします。
• ステージ3：サポートリソース：Claudeは必要に応じてスクリプト、例、参照、テンプレートを読み込みます。参照ファイルやデータは読み込まれるまでトークンを消費しません。スクリプトはbash経由で実行され、出力のみがコンテキストを消費します。

重要な結果：スキルコンテンツはセッション中持続します。Claude Codeでスキルが呼び出されると、レンダリングされたSKILL.mdが1つのメッセージとして会話に入り、セッションの残り部分に残ります。したがって、タスク全体に適用すべきガイダンスは一度きりの手順ではなく常設指示として記述します。SKILL.mdの各行は繰り返しトークンコストとなるため、本文は簡潔に保ち、詳細は参照ファイルに押し込みます。

スキルの構造

典型的なスキルディレクトリ：

• SKILL.md（必須）：YAMLフロントマター + Markdown指示
• references/：詳細情報（コーディング標準、ビジネスルールなど）
• examples/：良い結果と悪い結果の例
• templates/：固定出力構造
• scripts/：決定論的処理スクリプト

ファイルをバンドルするだけでは不十分で、SKILL.mdから明示的に参照する必要があります。SKILL.mdは約500行以下に保つことを推奨します。

フロントマターリファレンス

ポータブルコアフィールドはname（識別子/表示名）とdescription（機能と使用タイミング）で、全環境で機能します。Claude Codeでは全フィールドがオプションで、descriptionのみ推奨。その他、when_to_use（トリガーフレーズ）、argument-hint（オートコンプリートヒント）、arguments（名前付き位置引数）、disable-model-invocation（自動ロード禁止）、user-invocable（/メニュー非表示）、allowed-tools/disallowed-tools（ツール権限）、model（モデル指定）、effort（努力レベル）、context（サブエージェントコンテキスト）、hooks（ライフサイクルフック）、paths（自動活性化ファイルパターン）、shell（シェルタイプ）などがあります。

Claude.ai（Web/デスクトップアプリ）ではnameとdescriptionが必須で、nameは64文字、descriptionは200文字以内。オプションでdependencies（必要なパッケージ）を指定できます。

ハンズオンプロジェクト：データ品質監査スキルの構築

CSVデータセットを分析し、行数、列数、欠損値、重複レコード、データ型、高カーディナリティ列、定数列、数値要約、異常パターンをチェックするスキルを構築します。

前提条件

• Claude Codeインストール済み
• Python 3.9以上
• Pandas（pip install pandas）
• プロジェクトディレクトリとテスト用CSVファイル

ステップ1：スキルディレクトリ作成

プロジェクトレベルスキルの場合：

.claude/skills/data-quality-auditor/

個人スキル（全プロジェクトで使用可能）は~/.claude/skills/を使用。

ステップ2：SKILL.md作成

.claude/skills/data-quality-auditor/SKILL.mdに、YAMLフロントマターとMarkdown指示を記述。スキル名、説明、トリガー条件、具体的な監査手順を定義。例えば、allowed-toolsでPythonスクリプトの実行を許可。

ステップ3：監査スクリプト作成

scripts/ディレクトリにPythonスクリプト（例：audit.py）を作成。Pandasを使用してCSVを読み込み、各種統計情報を生成。Claudeが解析可能な形式で出力。

ステップ4：スキルの使用

Claude Codeでは/コマンドで呼び出すか、説明に基づいてClaudeが自動ロード。Web/デスクトップアプリでは、スキルディレクトリをアカウント設定にアップロードする必要があります。

結論

Claudeのカスタムスキルは、ワークフローを標準化し、一貫性と効率を向上させる強力なツールです。シンプルなMarkdown指示から、スクリプトや参照ファイルを含む複雑なスキルまで、ニーズに応じて拡張可能。コードレビュー、データ品質チェック、レポート生成など、反復作業を削減し、AIをチームに適応させます。