Claude Codeを導入したものの、定型作業の自動化がうまく進まないと感じていませんか。CLAUDE.mdやMCPとの違いが曖昧なまま、Skills機能を活用しきれていない方も少なくありません。
本記事では、Claude Code Skillsの基本概念や他機能との使い分け、コードレビュー自動化などのユースケース、SKILL.mdの書き方まで解説します。
なお、Claude Codeは非エンジニアにもおすすめのツールですが、今回はエンジニア向けに解説しています。特に、Claude Codeを使い始めたばかりでSkillsを作ったことがないエンジニアの方や、開発チーム内でSkillsを活用する際のオンボーディングにお役立てください。
Claude Code Skillsとは？他機能との違い・料金
ここでは、Claude Code Skillsの仕組みと位置づけを紹介します。
Claude Code Skillsとは
Claude Code Skillsとは、特定タスクの手順や知識をSKILL.mdにまとめる機能です。関連作業が発生すると自動でロードされ、以降は短い指示で複雑な処理を再現できます。
例えば「コードレビュー」Skillsを用意すれば、依頼時にClaude Codeが自動で呼び出し、セキュリティチェックから命名規則の確認まで一貫して実行します。
特徴的なのが、プログレッシブ・ディスクロージャーという読み込み方式です。起動時はSkillsの名前と説明文のみを読み込み、必要になった時点で本文をロードします。この仕組みには主に3つのメリットがあります。
- 数十個のSkillsを登録してもコンテキストをほとんど圧迫しない
- 必要なSkillsだけが必要なタイミングで展開される
- 不要な情報の読み込みによる精度低下を防げる
「必要な時に必要な知識だけを取り出す引き出し」に近く、Skillsを増やしても動作が重くなりません。
MCP・CLAUDE.mdとの違い
SkillsとMCP、CLAUDE.mdは、いずれもClaude Codeにナレッジやルールを追加して挙動をカスタマイズする機能です。目的が近く混同されがちですが、ロードの仕組みや適した用途が異なります。
3つの機能は役割が分かれています。それぞれの違いは以下の通りです。
| 機能 | ロード方式 | 主な用途 |
|---|---|---|
| Skills | 関連タスク時のみ動的ロード | 特定タスクの手順・ナレッジ |
| CLAUDE.md | セッション開始時に常時ロード | コーディング規約・命名ルールなど常設ルール |
| MCP | 起動時にサーバー接続 | 外部API・DBなどへの接続 |
CLAUDE.mdとSkillsはロード方式が異なります。CLAUDE.mdは全内容が毎回トークンを消費するため、何でも記述するとトークンが膨らみ応答品質が下がります。一方Skillsは呼び出されるまでロードされません。
迷ったときは、次の判断軸で選びましょう。
- 常時守らせたいルール → CLAUDE.mdに記載
- 特定タスクの手順・知識 → Skillsとして切り出す
- 外部サービスとの接続が必要 → MCPで設定する
これら3つは競合せず、組み合わせて使うことで真価を発揮します。
【Claude Code Skills利用者向け】Claudeの料金プラン
Skills機能はClaudeのProプラン以上で利用可能です。Freeプランでは使えないため、活用したい場合はProプラン以上への登録を検討しましょう。各プランの詳細は以下の通りです。
| プラン | 月額 | Skills利用 |
|---|---|---|
| Free | $0 | 不可 |
| Pro | $20 | 可 |
| Max 5x | $100 | 可 |
| Max 20x | $200 | 可 |
| Team | $25/$125 | 可 |
| Enterprise | 要見積 | 可 |
EnterpriseプランではSSO連携や監査ログ対応が加わるため、管理者による初期設定が別途必要です。
各プランの詳細は、公式サイトからご確認ください。
Claude Code Skillsでできること
ここでは、AI駆動開発を支えるSkillsの実務的な活用シーンを、3つのパターンに分けて解説します。
コードレビューを自動化する
コードレビューのSkillsは、あらかじめレビュー基準をSKILL.mdに定義しておくと、レビュー依頼のたびにClaudeがその基準に沿って差分を点検し、指摘を返す機能です。基準が明確な作業ほどSkills化しやすいため、最初に作るSkillsとして最適です。
まずは次のようなチェック項目をSKILL.mdに記載してください。
- 命名規則やディレクトリ構造の一貫性チェック
- セキュリティ・パフォーマンス上の定型パターン検出
- テストコードの有無や網羅率の確認
Skillsとして定義すれば、誰が依頼しても同じ基準で指摘が返り、新人エンジニアでもベテランと同水準のフィードバックを受けられます。初期レビューの工数が減る分、シニアメンバーは設計判断やアーキテクチャの議論に集中できます。
ただし、Skillsは万能ではありません。論理的なバグや設計上の妥当性は必ず人間が確認してください。
ドキュメントを生成・要約する
Skillsでドキュメント生成を自動化すれば、毎回ゼロから記述する手間を削減できます。自動化できるドキュメントは幅広く、たとえば次のようなものが対象です。
- API仕様書やREADMEの自動生成
- コミット履歴からの変更履歴（CHANGELOG）作成
- 長文コードの要約やインラインコメント付与
品質を安定させるポイントは、出力テンプレートをSKILL.mdに組み込むことです。Markdownテンプレートを定義すれば誰が実行しても同じフォーマットで出力され、書式の揺れが発生しません。
ただし、すべてを丸投げはできません。定型的なセクション構成や書式の適用は完全自動化に向いていますが、プロジェクト固有の背景説明や判断を含む記述は、生成後に人間が確認・調整してください。
開発フローを標準化する
デプロイやリリースの手順をSkillsとしてパッケージ化すれば、「誰が実行しても同じ品質」の開発フローが実現できます。Skills化に迷った際は、頻度が高く手順が明確なもの、開発チームで活用する場合はROI（投資対効果）の大きいものから着手しましょう。
具体的には、以下の作業が候補になります。
| 作業例 | 頻度 | 標準化しやすさ |
|---|---|---|
| 定期デプロイ | 高 | 高 |
| コミットメッセージチェック | 高 | 高 |
| リリースノート作成 | 中 | 高 |
| ホットフィックス対応 | 低 | 中 |
複雑な操作ほど明確なステップに分解し、チェックリスト形式で落とし込むと精度が上がります。
アイスリーデザインでは、デザイナーとエンジニアが同一チームで動くワンストップ体制で、構想からPoC・実装・運用改善まで一貫して支援しています。
大手企業のアプリ刷新や生成AI導入の実績をもとに、貴社に合った進め方をご提案しますので、お気軽にご相談ください。
Claude Code Skillsの作り方
ここでは、Skillsを作成する手順をステップごとに解説します。
各ステップを押さえれば、初めてのSkills作成でもつまずくことなく実装を進められます。
Skills用のフォルダとファイルを作る
Skillsの最小構成は、フォルダ1つとSKILL.md1つだけです。30行程度でも十分機能します。
作成前に、設定＞機能で「コード実行」を、カスタマイズ＞スキルでSkills機能を有効化しておきましょう。
次に配置先を決めます。
| 配置先 | 用途 | 可視範囲 |
|---|---|---|
| ~/.claude/skills/ | 個人の定型作業 | 全プロジェクト共通 |
| .claude/skills/ | チーム共有・標準化 | 該当プロジェクトのみ |
自分専用なら個人用、チーム共有ならプロジェクト用を選び、配下にSkills名のフォルダを作ってSKILL.mdを置けば準備完了です。
Skillsが大きくなったら、scripts/（自動実行スクリプト）、reference.md（補足仕様）、assets/（テンプレート）を追加できます。本文が500行を超える場合は詳細を別ファイルへ分割し、SKILL.md本体はメニュー的な役割に留めましょう。
フロントマター（name・description）を書く
フロントマターには、nameとdescriptionの2つが必須で、この記述の精度が自動トリガーの精度を大きく左右します。
nameは識別名で、最大64文字、使用できる文字は小文字・数字・ハイフンのみです。「code-review」のように、動名詞形で役割が判別できる名称にしましょう。
descriptionは、トリガー精度を左右する重要な項目です。最大1024文字以内、三人称で記述し、XMLタグは使えません。盛り込むべき要素は以下の3つです。
- 何をするか：Skillsの具体的な処理内容
- いつ使うか：発動すべき場面や条件
- トリガー語：ユーザーが使いそうなキーワード
よくある失敗例が「コードを改善する」のような曖昧な記述です。これではClaudeが呼び出す場面を判断できません。
「ユーザーがプルリクエストのレビューを依頼した際、差分を取得してコーディング規約に沿ったフィードバックを生成する」のように具体的に書くと、トリガーの一致度が格段に向上します。
本文に実行手順とコンテキストを定義する
フロントマターの記述後は、本文パートを作成します。Claudeが実行すべき手順・判断基準・参照情報をMarkdownで記述し、「入力→処理→出力」の流れを明確にしましょう。
本文には、以下の要素を盛り込みます。
- 入力：どんなファイルや情報を受け取るか
- 処理：ステップバイステップで何を行うか
- 出力：最終的に何を返すか、完了の条件は何か
コードレビューSkillsなら「差分ファイルを受け取り→命名規則を確認し→指摘一覧をテーブルで出力する」といった構成になります。完了条件が曖昧だと、Claudeが処理を終えられず意図しない動作につながるため、注意が必要です。
作成したSkillsを呼び出す
呼び出し方法は大きく2種類です。
自動トリガーはプロンプトがdescriptionの条件と一致すると自動で読み込まれ、スラッシュコマンドは/skill-nameで直接指定します。使い分けの基準は以下の通りです。
| 呼び出し方法 | 向いている場面 | 注意点 |
|---|---|---|
| 自動トリガー | 日常的な定型作業を自然な流れで実行 | 意図しない場面で発火するリスクあり |
| スラッシュコマンド | 確実性が求められる重要な処理 | 毎回手動入力が必要 |
普段は自動トリガーに任せ、確実性が必要な処理だけスラッシュコマンドで明示的に呼ぶ、といった併用も可能です。
Claude Code Skillsに関するよくある質問
ここでは、運用中に生じやすい疑問をQ&A形式で解説します。
- Skillsが動かない・誤発火するときの対処は？
- どのSkillsから始めればいい？
- Claude Code Skillsを簡単に作る方法は？
- Skillsの実行権限を制限できる？
- チームでSkillsを共有できる？
- コミュニティのSkillsを入れても安全？
実装後のつまずき解消にお役立てください。
Q. Skillsが動かない・誤発火するときの対処は？
動作しない原因の多くは、descriptionの記述品質にあります。まずは記述を見直しましょう。症状ごとの対処法を紹介します。
| 症状 | 主な原因 | 対処法 |
|---|---|---|
| Skillsが発火しない | descriptionが曖昧でトリガー語が不足 | ユーザーが自然に使う言葉とkey use caseを先頭に追記 |
| 意図しない場面で発火する | 適用範囲が広すぎる | descriptionに「DO NOT TRIGGER when:」で除外条件を追記 |
| 途中で止まる・出力が不完全 | 手順の終了条件が不明確 | 完了基準を本文に明記し、出力フォーマットを指定 |
誤発火が頻発する場合は、登録スキル数が過剰でないか確認してください。類似Skillsが多いとClaudeが判断に迷うため、統合や優先度を見直しましょう。
それでも解消しないときは、セッションを再起動すると復旧する場合があります。
Q. どのSkillsから始めればいい？
選定基準はシンプルです。「毎日発生する」かつ「手順が固定されている」作業から始めましょう。
特におすすめがコードレビューの自動化です。理由は以下の3点です。
- 構文チェックやDRY原則の確認など、属人性が低く標準化しやすい
- PRが発生するたびに動くため、工数削減の効果が目に見えやすい
- CLAUDE.mdにレビュー基準を書いておけば、プロジェクト固有のルールも反映できる
うまくいかなくても設定を元に戻すだけで従来のレビュー体制にすぐ戻せるため、失敗リスクも小さく済みます。逆に、属人的で判断が必要な作業はルール化が難しいので避け、まずはコードレビューで成功パターンを作ってから展開しましょう。
Q. Claude Code Skillsを簡単に作る方法は？
公式のskill-creatorを使えば、SKILL.mdを手動で書く手間はほぼ不要です。「コードレビュー用のSkillsを作りたい」と用途を伝えるだけで、対話的に構築してくれます。作成の流れは以下の通りです。
- 目的や対象言語などをヒアリングされるので、自然言語で答える
- 回答をもとにSKILL.mdの初稿が自動生成される
- Evalでテストし、結果を見ながら修正指示を出す
skill-creatorは、トリガー精度を左右するdescriptionも自動で最適化してくれます。モデルが解釈しやすい表現を選ぶため、初心者でも発火不良を避けやすくなります。
修正指示のポイントは条件の明確化です。「もっと具体的に」ではなく「TypeScriptのPRのみに反応させたい」と明示すると、精度が向上します。
Q. Skillsの実行権限を制限できる？
permissions設定でスキルが実行できる操作を細かく制御でき、基本は「最小権限の原則」で運用します。Read権限のみを許可し、必要に応じてWriteやBash実行を解禁します。ルールには優先順位があります。
| ルール | 動作 | 優先度 |
|---|---|---|
| Deny | 対象操作を完全にブロック | 最高（他を上書き） |
| Ask | 実行前に確認プロンプトを表示 | 中 |
| Allow | 確認なしで自動承認 | 低 |
コードレビューSkillsならファイル読み取りをAllow、削除をDenyにすれば、誤って重要なファイルを消す事故を防げます。チーム運用では次の方針が安全です。
- 副作用のある操作（デプロイ・DB変更など）はAskで手動確認を必須にする
- デフォルト許可の拡大は避け、個別のAllowルールで対応する
- 設定は
.claude/settings.jsonに記述してバージョン管理する
重大な事故を防ぐため、迷ったらAskを選択しましょう。
Q. チームでSkillsを共有できる？
Skillsファイルを.claude/skills/ディレクトリに置いてGit管理すれば、クローンした全メンバーが同じSkillsセットを利用できます。追加や修正もソースコードと同様にPRレビューを経由すると、属人化を防ぎつつ品質を担保できます。
複数リポジトリを扱う環境では、共有方法の選択が重要です。
| 共有方法 | メリット | 向いているケース |
|---|---|---|
| 共通Skillsリポジトリ＋シンボリックリンク | 一元管理でき、更新が即反映 | リポジトリ数が多い大規模チーム |
| Gitサブモジュール | バージョン固定で安定運用 | Skillsの変更頻度が低い場合 |
| 手動コピー | 導入が最も簡単 | リポジトリが2〜3個の小規模チーム |
更新時にはバージョンタグを付与し、「いつ・誰が・何を変更したか」を追跡できる状態に保ちましょう。
Q. コミュニティのSkillsを入れても安全？
コミュニティ製Skillsは便利ですが、導入前にコードの中身を直接確認することが大前提です。SkillsはSKILL.mdだけでなく同梱スクリプトも実行権限を持つため、悪意あるコードが混入していればファイル改変や外部へのデータ送信といったリスクが顕在化します。
導入前のチェック項目は以下の通りです。
- SKILL.mdと同梱スクリプトの中身を目視で確認する
- 未文書のネットワーク通信や過大な権限要求がないか検査する
- 提供元のGitHubスター数・更新頻度・ライセンスを確認する
これらを確認できないSkillsは、導入を見送るのが安全です。
まとめ
Claude Code Skillsは、SKILL.mdひとつで定型作業を自動化し、チームのナレッジを共有できる仕組みです。小規模なSkillsから始め、実際の動作を確認しながら拡張していくのがおすすめです。
本記事を参考に、自身のプロジェクトに最適なSkillsを設計してみましょう。
アイスリーデザインは、AI駆動開発コンソーシアムにも加盟する、デザイン×エンジニアリング一体型の開発パートナーです。ツールの導入から内製化、リリース後のグロースまでワンチームで伴走しますので、ご相談やお見積もりはお気軽にお問い合わせください。
Claude CodeなどのAIツールを導入したものの、開発現場にうまく定着しないと感じていませんか。アイスリーデザインでは、開発スピードと品質を両立したAI駆動開発を提供しています。
プロンプト設計からAIコードレビューの仕組み化まで、AI駆動開発の定着をまるごと支援しますので、お気軽にご相談ください。
＞AI駆動開発支援について詳しく見る