Claude Code Atlas
#08

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 はスラッシュコマンド(/commit・/init など)とは別の仕組みです。スラッシュコマンドは Claude に特定の作業を依頼するショートカット、Skills は Claude が参照する「指示書ファイル」です。

実践手順

ステップ1:ターミナルを開いてプロジェクトフォルダへ移動する

お使いの OS タブを選んでターミナルを起動し、プロジェクトフォルダへ移動してください。

Windows(PowerShell)

  1. 1. PowerShell を起動する

    スタートメニューで「powershell」と検索し、「Windows PowerShell」をクリックして起動してください。

  2. 2. プロジェクトフォルダへ移動する

    以下のコマンドでプロジェクトフォルダへ移動してください。パスはご自身の環境に合わせて変更してください。

    powershell
    cd C:\Users\your-username\your-project

ステップ2:.claude/skills/ フォルダを作成する

プロジェクトルートに `.claude/skills/` フォルダを作成します。すでに存在する場合はスキップしてください。

zsh
mkdir -p .claude/skills

ステップ3:Skill ファイルを作成する

お好きなエディタで `.claude/skills/` フォルダ内に Markdown ファイルを作成します。ファイル名はスキルの目的を表す名前にしましょう(例:`my-style.md`)。ファイルに Claude への指示を書いてください。

markdown
# コーディングスタイルガイド

## ルール
- インデントは2スペースを使用する
- コメントは日本語で書く
- 変数名は英語(キャメルケース)にする

ステップ4:Claude Code を起動して Skill が参照されることを確認する

Claude Code を起動して、Skill ファイルに書いたルールに関係する作業を依頼してみてください。Claude がファイルの内容を参照して応答することを確認できます。

zsh
claude

確認チェック

講座を終える前に、以下の項目を確認しましょう。

関連講座

「確認チェック」の全項目にチェックを入れると完了できます