Skillsの概要と使い方
下級Claude Codeを拡張するSkills（スキル）の仕組みと活用方法を学びます。
座学
この講座で学べること
- ✓Skillsが .claude/skills/ フォルダのMarkdownファイルであることを理解する
- ✓Skillsとスラッシュコマンド（/commit など）は別の仕組みであることを把握する
- ✓プロジェクト単位とグローバル（~/.claude/skills/）の2種類の配置場所を知る
- ✓実際にSkillファイルを作成してClaude Codeに参照させる体験をする
Skills（スキル）は、`.claude/skills/` フォルダに置いた Markdown ファイルです。スラッシュコマンドとは別の概念で、ファイルに書いた内容が Claude への指示として参照されます。プロジェクトごとに独自のルールやガイドラインを Skill として定義しておくことで、Claude が作業するたびにその指示を自動で参照してくれます。 例えば「コードブロックの表示スタイルはこのルールに従ってほしい」「コンポーネントは必ずこの形式で作成してほしい」といった繰り返し伝えたい指示を Skill に書いておくと、毎回同じ内容をプロンプトに書かずに済みます。
Skill ファイルは通常の Markdown で書きます。ファイル名はスキルの目的を表す名前にします（例：`code-snippet-style.md`、`component-template.md`）。 このプロジェクト（Claude Code Atlas）でも `.claude/skills/code-snippet-style.md` という実際の Skill を使っています。コードブロックの見た目・OS別タブの仕様・個人情報の扱いなど、全講座共通のコーディングルールをこのファイルに記述してあります。Claude はコンポーネントを作るたびにこの Skill を参照して一貫したスタイルで実装します。
Skill ファイルの配置場所には2種類あります。 ・プロジェクト単位：`.claude/skills/` フォルダ（そのプロジェクト内でのみ有効） ・グローバル：`~/.claude/skills/` フォルダ（全プロジェクトで有効） プロジェクト固有のコーディング規約はプロジェクト単位に、どのプロジェクトでも使いたい汎用ルールはグローバルに置くと便利です。CLAUDE.md が「プロジェクトの説明書」なら、Skills は「繰り返し参照したい詳細なルール集」と考えると分かりやすいでしょう。
Skills の実践的な活用例として、コンポーネントのテンプレートを定義しておく使い方があります。例えば「Reactコンポーネントは必ずこのディレクトリ構造で作成する」「テストファイルは必ず同じフォルダに配置する」といったルールを Skill ファイルに書いておくと、Claude Code がコンポーネントを作るたびにそのルールに従って実装してくれます。チーム開発では全員の `.claude/skills/` に同じファイルを共有することでコードの一貫性を保てます。
実践手順
ステップ1：ターミナルを開いてプロジェクトフォルダへ移動する
お使いの OS タブを選んでターミナルを起動し、プロジェクトフォルダへ移動してください。
Windows（PowerShell）
1. PowerShell を起動する
スタートメニューで「powershell」と検索し、「Windows PowerShell」をクリックして起動してください。
2. プロジェクトフォルダへ移動する
以下のコマンドでプロジェクトフォルダへ移動してください。パスはご自身の環境に合わせて変更してください。
powershellcd C:\Users\your-username\your-project
ステップ2：.claude/skills/ フォルダを作成する
プロジェクトルートに `.claude/skills/` フォルダを作成します。すでに存在する場合はスキップしてください。
mkdir -p .claude/skillsステップ3：Skill ファイルを作成する
お好きなエディタで `.claude/skills/` フォルダ内に Markdown ファイルを作成します。ファイル名はスキルの目的を表す名前にしましょう（例：`my-style.md`）。ファイルに Claude への指示を書いてください。
# コーディングスタイルガイド
## ルール
- インデントは2スペースを使用する
- コメントは日本語で書く
- 変数名は英語（キャメルケース）にするステップ4：Claude Code を起動して Skill が参照されることを確認する
Claude Code を起動して、Skill ファイルに書いたルールに関係する作業を依頼してみてください。Claude がファイルの内容を参照して応答することを確認できます。
claude確認チェック
講座を終える前に、以下の項目を確認しましょう。
よくある質問
Q. Skills と CLAUDE.md はどう使い分ければいいですか？
A. CLAUDE.md は「プロジェクト全体の概要・背景・ルール」を書く場所です。Skills は「特定の作業に関する詳細なガイドライン」を書く場所です。例えば「このプロジェクトはNext.jsを使う」はCLAUDE.mdに、「コンポーネントの作り方のテンプレート」はSkillsに書くのが適切です。詳細な手順書や長い規約はSkillsに切り出してCLAUDE.mdをすっきり保ちましょう。
Q. Skill ファイルは何個まで作れますか？
A. 上限はありません。ただし、ファイルが増えるほどClaudeが読み込む量も増えます。5〜10ファイル程度が現実的な上限の目安です。それ以上になる場合は、関連する内容を1ファイルにまとめる整理をおすすめします。
Q. Skill が実際に参照されているか確認する方法はありますか？
A. Claude Code に「.claude/skills/ の内容を確認してください」と聞くと、存在するSkillファイルの一覧と内容を表示してくれます。また、Skillに書いたルールに関係する作業を依頼して、ルール通りに動いているか見るのが一番分かりやすい確認方法です。