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 は「繰り返し参照したい詳細なルール集」と考えると分かりやすいでしょう。
実践手順
ステップ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確認チェック
講座を終える前に、以下の項目を確認しましょう。
