Claude CodeのSkillsとは？使うための準備・使い方・自作例を初心者向けに解説

生成AI

最終更新日: 2026/07/07

この記事のポイント

Skillsとは、よく使う指示をファイルに保存しておき、必要なときに呼び出せる仕組みです。使い始めるための準備から、実際の使い方、自作の考え方まで順番に確認していきましょう。

Claude CodeのSkillsとは何か、CLAUDE.mdやカスタムコマンドとの違い
Skillsを使い始めるための環境準備と、公式ドキュメントで確認すべきポイント
初心者が試しやすいSkillsの使い方と、自作する際の基本的な考え方

「何となく使いこなせていない、手間が多い」という方はぜひ参考にしてください。

Claude CodeのSkillsとは？

Skillsとは、Claude Codeに「この作業はこうやって」と覚えさせるための仕組みです。よく使う手順をファイルに書いておくだけで、必要なときに呼び出して使えます。

まずはSkillsの基本的な役割と、似た機能との違いを解説します。

Skillsの基本

SkillsはClaude Codeに組み込まれた機能の一つです。

別途ダウンロードや導入の必要はなく、「特定の作業手順をファイルに記述すると、Claude Codeが必要なときに読み込んで実行する」という仕組みです。

このSkillsを使うには、.claude/skills/というフォルダの中にSKILL.mdというファイルを作成し、手順を書いておきます。

例えば「コードをレビューするときはこの観点でチェックして」という指示を毎回入力している場合、その内容をあらかじめ書いておくだけでOKです。

Skillsの使い方は2通りあります。

/スキル名と入力して直接呼び出す方法
関連する依頼をしたときにClaude Codeが自動的に判断して使ってくれる方法

です。どちらの場合も、プログラムを組む必要はありません。

「指示しなくてもClaude Codeを自動化できる」という使い方と同じ文脈で語られるため、初心者だと「難しい自動化ツール？」と思われがちです。

実際には少し異なり、「よく使う指示をメモしておき、呼び出せる」のがSkillsの特徴とだけ捉えておきましょう。

CLAUDE.mdやカスタムコマンドとの違い

Claude Codeには、Skillsと混同されやすい機能があります。しかし、実際に触ってみると記述する場所そのものが異なり、別機能だとすぐに気づきます。

CLAUDE.mdはプロジェクトのルートフォルダに置く設定ファイルで、Claude Codeを起動すると自動的に読み込まれます。「このプロジェクトではPythonを使う」「コメントは日本語で書く」といった、常に適用したいルールを書く場所です。

Skillsは.claude/skills/フォルダの中に作成します。特定の作業をするときだけ読み込まれるため、「毎回ではなく必要なときだけ使う指示」を書く場所として使い分けます。

またClaude Codeには以前「カスタムコマンド」という機能がありましたが、現在はSkillsに統合されています。今から使い始める場合はSkillsだけ覚えておけば問題ありません。

両者の書き方や使い方は、以下を参考にしてみましょう。

CLAUDE.mdの書き方：Claude Codeのマル秘活用テクニック7選！初心者でもできる開発効率アップのコツ
Skillsの記述方法：本記事で解説します

Skillsが向いている作業の一覧

Skillsは、同じ手順を繰り返す作業との相性が特に良い機能です。

例を挙げて、以下にまとめました。

作業	どう使う？
コードレビュー	チェックする観点をSkillsに書いておくことで、毎回同じ基準でコードを確認できます。
変更内容の要約	コードを修正したあと、何をどう変えたかをまとめる作業を自動化できます。
テスト前の確認	動作確認の手順をまとめておくことで、確認漏れを防げます。
書いたコードへのフィードバック	学習中に書いたコードを決まった観点で振り返る用途にも使えます。

注目しておきたいのは、以上の可能な作業を見てみると「必ずしもSkillsを活用しなくてもよい」という点です。まずは「知っておけば便利だし、作業が安定する」と覚えておきましょう。

Claude Codeのインストールと公式情報の確認

Skillsを使い始める前に、Claude Codeが使える状態になっているかどうかを確認しておきましょう。

インストール方法と公式ドキュメントで確認すべきポイントを順番に解説します。

Claude Codeのインストール方法

Claude Codeはブラウザ上では動作しません。ターミナルやVS CodeなどのエディタにClaude Codeを導入して使う形になります。この際の連携方法はさほど複雑ではなく、拡張機能の追加やClaude Codeへのログインだけで完了できます。

ただし、Claude Codeの利用には有料プランへの加入、またはAPIキーの発行が必要です。無料プランでは使用できない点に注意しましょう。

2026年6月時点では、Proプランを利用するには月額20ドル（約3230円）がかかります。

インストールの手順とは、

Anthropicのアカウント作成と有料プランに加入する
Node.jsをインストールする
ターミナルからClaude Codeをインストールする

という流れです。

macOS・Windows・Linuxのいずれにも対応していますが、環境によって手順が異なります。

Skillsの公式ドキュメントの見方

Skillsの仕様や設定方法を確認するには、Anthropicの公式ドキュメントを参照するのが確実です。日本語版も用意されています。

ページを開いたら、まず以下の順番で確認してみましょう。

Skillsの概要：Skillsが何をする機能なのか、基本的な役割を確認します
保存場所：SKILL.mdをどのフォルダに置けばよいかを確認します
SKILL.mdの書き方：フロントマターと本文の構成を確認します
設定項目：descriptionなど、各フィールドの役割を確認します
トラブル対応：Skillsが呼び出されないときの確認ポイントも記載されています

最初からすべてを読み込まなくてもOKです。

本記事と並行して、わからない点が出てきたときに該当箇所を確認する使い方がおすすめです。

初心者が先に確認したい前提知識

Skillsではさまざまな聞き慣れない言葉を使いますが、初心者の場合、以下の用語の意味だけを覚えておきましょう。深く理解する必要はなく、本記事でも単語が出てきた場合振り返ってみてください。

用語	意味
ターミナル	コンピューターにテキストで命令を入力する画面のことです。Claude Codeはこのターミナル上で動作します。
プロジェクトフォルダ	作業中のファイルをまとめて入れておくフォルダを指します。Skillsはこのフォルダの中に作成します。
Markdown	「##」や「-」などの記号を使って文章を装飾するための書き方です。SKILL.mdはこの形式で記述します。
YAML	設定情報を書くための書き方で、「---」で囲まれた部分がこれにあたります。SKILL.mdの冒頭部分（フロントマター）で使います。

Skillsの使い方と具体例

ここからは、Skillsの実際の使い方を解説します。

呼び出し方の基本から、SKILL.mdの書き方、初心者が試しやすい活用例、うまく動かないときの対処法まで確認していきましょう。

Skillsの呼び出し方

Skillsの呼び出し方には2種類あります。

1. /スキル名で直接呼び出す

ターミナル上で/スキル名と入力するだけで、そのSkillsが起動します。「このSkillsを使いたい」と決まっているときに向いています。

2. 依頼の内容からClaudeが自動で判断して使う

SKILL.mdにはdescriptionという欄があり、「どんな依頼が来たときにこのSkillsを使うか」を書いておけます。

例えば「コードレビューを依頼されたときに使う」と書いておくと、「このコードを見てほしい」と普通に話しかけるだけで、Claude Codeが自動的にそのSkillsを読み込んで動いてくれます。

どちらを使うかの目安としては、慣れないうちは直接呼び出す方法の方がおすすめです。

自動呼び出しはdescriptionの書き方次第で精度が変わり、複雑な使い方もできる一方でdescriptionの設計力が求められるからです。

まずは/スキル名で動作を確認してから、慣れてきたら自動呼び出しも試してみましょう。

SKILL.mdの基本構成

SKILL.mdは大きく2つのパートに分かれています。

＜フロントマター＞

---で囲まれた冒頭部分です。ここにはSkillsの名前や、どんな依頼が来たときに使うかを書きます。

特にdescriptionの内容は、Claude Codeが「このSkillsを使うべきかどうか」を判断する際に参照するため、具体的に書くほど精度が上がる仕組みです。

---
name: code-review
description: コードレビューを依頼されたときに使う。品質確認や修正提案を求められた場合も対象。
---

＜本文＞

フロントマター以降の部分です。「このSkillsが呼び出されたときに、Claudeにどう動いてほしいか」を書く場所です。

箇条書きや番号付きリストで手順を書くと、Claudeが読み取りやすくなると言われています。

初心者のうちは、本文をシンプルに保つことを意識しましょう。最初から複雑な手順を詰め込むより、「まず試して、少しずつ手順を追加していく」方が使いこなしやすいです。

初心者におすすめの利用例

業務でSkillsを使う場合はチームでの効率化が中心です。ただし、学習中の初心者であれば「個人開発やポートフォリオ作成に役立てる」という使い方をおすすめします。

以下に、初心者が試しやすい例を具体的にまとめました。

書いたコードを毎回同じ観点でレビューしてもらう

ポートフォリオ用のコードを書いたあと、「読みやすいか」「無駄な処理がないか」といった観点を毎回Skillsに書いておくと、一定の品質で確認作業を繰り返せます。

自己流のチェックでは見落としがちな点も、観点を固定することでカバーしやすくなります。

エラーが出たときの調査手順を固定する

「エラーメッセージをここに貼って、原因と修正案を出して」という流れをSkillsに書いておくと、毎回同じ手順でデバッグを進められます。対処法を探して迷う時間が減り、学習のリズムが崩れにくくなります。

コミット前に変更内容を要約してもらう

Gitを使い始めた段階におすすめの使い方です。「何を変えたかをまとめて」という手順をSkillsに書いておくと、コミットメッセージを書く練習にもなります。変更の記録を残す習慣がつきやすくなります。

以上のように、Skillsは「難しく使う必要はない」ことがわかります。学習の効率化や自分ではまだ難しい作業の補助としてさわってみましょう。

うまく動かないときの確認点

Skillsが思ったように動かない場合、ほとんどがdescriptionの書き方に原因があります。

以下、トラブル別に確認すべき部分をまとめました。

症状	原因	対処法
Skillsが呼び出されない	descriptionの内容が曖昧で、Claude Codeが「使うべき場面」を判断できていない	descriptionに「どんな依頼が来たときに使うか」を具体的に書き直す
意図しない場面で動く	descriptionの書き方が広すぎて、関係ない依頼にも反応してしまっている	使う場面をより絞り込んだ表現に修正する
手順通りに動かない	本文の指示が長すぎたり、曖昧な表現が含まれている	手順を短く分けて、1ステップずつ具体的に書き直す

いずれの場合も、まずdescriptionと本文をシンプルに書き直すことから始めてみましょう。

便利な機能だからこそ「あれもこれもやって欲しい」と長文の記述になりがちですが、複雑な設定よりも短くて具体的な指示の方がうまく動くケースが多いです。

skill-creatorを使った自作の考え方

ここまでは既存のSkillsの使い方を解説しました。

次は自分でSkillsを作る方法を紹介します。作成を助けてくれる「skill-creator」の使い方から、自作する前に決めておくべきこと、安全に使うための注意点まで確認していきましょう。

自作前に決めるべきこと

Skillsを自作する前に、まずは以下のテンプレートをコピーして動かしてみましょう。

実際に動く状態を先に確認してから自分の用途に合わせて書き換えていくと、Skillsをどう動かすかがわかりやすくなります。

---
name: my-first-skill
description: （どんな依頼が来たときに使うかを書く）
---
## 手順
1. （Claudeにやってほしいことを書く）
2. （結果をどう出力してほしいかを書く）

このテンプレートを動かしたうえで、以下の3点を決めると自作がスムーズになります。

何をしてほしいか：毎回同じ手順で頼んでいる作業があれば、それがSkills化の候補です
いつ使うか：「コードを書いたあと」「コミット前」など、使う場面を具体的に決めておきます
どんな出力にしたいか：箇条書きで出してほしい、要約だけでいいなど、出力の形を決めておくと指示が書きやすくなります

曖昧なまま作り始めると、Skillsがうまく動かなかったときに「どこが問題か」がわかりにくくなります。最初はシンプルな用途に絞って作るのがおすすめです。

skill-creatorの役割

Skillsをゼロから自分で書くのが難しいと感じたときに活用できるのが、Anthropicの公式リポジトリで提供されている「Skill Creator」です。

skill-creatorを使うと、「こういうSkillsを作りたい」と伝えるだけで、Claude Codeと対話しながらSKILL.mdを作成できます。

何を自動化したいかを整理しながら進められるため、初心者でも取り組みやすいのが特徴です。

導入はclaude.com/plugins/skill-creatorからインストールできます。インストール後は/skill-creatorと入力して起動します。

なお、skill-creatorはあくまで作成を支援するツールです。先ほどSkillsを自分で作る前に考える「何をしてほしいか」「いつ使うか」「どんな出力にしたいか」をある程度決めてから使うと、より効果的に活用できます。

自作Skillsの簡単な例

実際にSKILL.mdがどのような形になるか、2つの例をご紹介します。

＜変更内容を要約するSkills＞

---
name: summarize-changes
description: コードの変更内容を要約する。「何を変えたか教えて」「変更をまとめて」と依頼されたときに使う。
---

## 手順
1. 変更したファイルと内容を確認する
2. 以下の形式で要約する
   - 変更したファイル名
   - 変更の目的
   - 具体的に変えた内容（箇条書き）
3. 気になる点があれば最後に補足する

＜レビュー観点を固定するSkills＞

---
name: code-review
description: コードをレビューする。「このコードを見て」「レビューして」と依頼されたときに使う。
---

## レビュー観点
以下の順番で確認する。

1. 動作の正しさ：意図した通りに動くか
2. 読みやすさ：変数名や処理の流れがわかりやすいか
3. 無駄な処理：同じ処理が繰り返されていないか
4. 改善提案：より良い書き方があれば提案する

どちらの例にも「あいまいさを避けた具体的な指示」「本文は箇条書きなどを使って分かりやすく」「シンプルな構成」を守っています。

Claude Codeが読み取りやすい形に整えると、うまく動かしやすくなるでしょう。

安全に使うための注意点

Skillsは便利な機能であり、中には「便利なSkillsを配布中」といった外部から取り込めるものもあります。この「外部から入手したもの」を使う際はいくつか注意が必要です。

外部で公開されているSkillsは、中身を確認してから使う。SKILL.mdに書かれた指示がそのまま実行されるため、信頼できる提供元かどうかを確認する
パスワードやAPIキーなどの重要情報をSKILL.mdに直接書き込まない
ファイルの削除や外部サービスへの送信など、取り消しのきかない処理が含まれるSkillsは実行前に内容をよく確認する

自分で作ったSkillsであれば基本的には問題ありません。

ただし、外部から入手したものはAnthropicの公式ドキュメントでも「ソフトウェアをインストールするのと同じ感覚で扱うこと」と記載されており、「中身を確認せずにそのまま信用して使うのは避ける」意識を持っておきましょう。

よくある質問（Q&A）

Q. Skillsを使うにはインストールが必要？

A. Skillsを使うには、まずClaude Codeを使える状態にする必要があります。Claude Codeの導入方法は以下の記事で詳しく解説しています。

Skillsそのものは追加のインストール不要で、所定のフォルダにSKILL.mdを置くだけで使えます。

Q. Skillsとプロンプトの違いは？

A. プロンプトはその場限りの指示です。Skillsは繰り返し使う手順をファイルとして保存しておき、必要なときに呼び出すものという違いがあります。

Q. 初心者におすすめのSkillsの使い方は？

A. コードレビューや変更内容の要約、テスト前チェックなどがおすすめです。作業内容が明確で効果を確認しやすく、SKILL.mdもシンプルに書けるため、最初の一歩として取り組みやすいです。

Q. Skillsがうまく呼び出せない原因は？

A. descriptionの書き方が曖昧なケースが多いです。「どんな依頼が来たときに使うか」を具体的に書き直すと改善されることがあります。詳しくは本記事の「うまく動かないときの確認点」を参照してください。

Q. 公式以外のSkillsを使っても大丈夫？

A. 使う前に必ずSKILL.mdの中身を確認しましょう。特にファイル操作や外部サービス連携を含むものは、何を実行するか理解してから使う必要があります。

Q. Skillsは他の機能と組み合わせられる？

A. 可能です。コードレビューやテスト、ドキュメント作成など、Claude Codeの他の機能とあわせて使うと効果的です。慣れてきたら複数のSkillsを用途別に作成して使い分けるのもおすすめです。

まとめ

この記事では、Claude CodeのSkills機能について、基本的な仕組みから使い方、自作の考え方まで解説しました。

SkillsはClaude Codeに組み込まれた機能のこと。必要なときに呼び出して使える。
CLAUDE.mdは常時読み込まれるプロジェクト全体の設定ファイルだが、Skillsは必要なときだけ読み込まれる「作業別の指示書」として使う。
呼び出しは/スキル名で直接行う方法と、依頼の内容からClaude Codeが自動で判断して使う方法の2種類がある。
自作する際は「何をしてほしいか」「いつ使うか」「どんな出力にしたいか」を先に設計し、シンプルな構成で作る。
外部から入手したSkillsは中身を確認してから使い、重要情報をSKILL.mdに書き込まないよう注意する。

Skillsは難しい自動化ツールではなく、「よく使う指示をメモしておく」という感覚で始められる機能です。まずは本記事で紹介した例をそのまま試してみることから始めてみましょう。

paizaラーニングでは、「バイブコーディング入門 Claude Code編」講座を公開しています。プログラミング学習とあわせてClaude Codeを最大限活用してみましょう。

レベルを更に上げたい方はpaizaプログラミングスキルチェックへ