読み込み中

Skills とは?

レッスン 19 分
このレッスンの内容このレッスンを終えると、次のことができるようになります
  • Claude Code の Skills とは何か、どのように機能するかを定義する
  • Skills がどこに配置されるか(個人用ディレクトリとプロジェクト用ディレクトリ)を説明する
  • Skills、CLAUDE.md、スラッシュコマンドの違いを区別する
  • Skills が適切なカスタマイズツールとなるシナリオを特定する

Skills とは?

読み込み中

Skills とは? · 3 min

要約文字起こし

このビデオでは、Skills — Claude Code に特定のタスクの処理方法を自動的に教える、再利用可能な markdown ファイル — を紹介します。PR のレビューやコミットメッセージの作成を Claude に依頼するたびに毎回指示を繰り返す代わりに、 Skill を一度書いておけば、そのタスクが発生するたびに Claude がそれを適用します。このビデオでは、 Skills とは何か、どこに配置されるか、そして他の Claude Code カスタマイズオプションとどう比較されるかを説明します。

重要なポイント

  • Skills は指示をまとめたフォルダであり、Claude Code がタスクをより正確に処理するために発見して使用できます。各 Skill は、フロントマターに名前と説明を持つ SKILL.md ファイルに格納されています
  • Claude は説明(description)を使って、Skills をリクエストに一致させます。 何かを依頼すると、Claude はそのリクエストを利用可能な Skill の説明と比較し、一致するものを有効化します
  • 個人用 Skills は ~/.claude/skills に配置され、すべてのプロジェクトにわたって利用できます。プロジェクト用 Skills はリポジトリ内の .claude/skills に配置され、そのリポジトリをクローンした人と共有されます
  • Skills はオンデマンドで読み込まれます — あらゆる会話に読み込まれる CLAUDE.md や、明示的な呼び出しが必要なスラッシュコマンドとは異なり、Skills は Claude が状況を認識すると自動的に有効化されます
  • 同じことを Claude に繰り返し説明していることに気づいたら、それは書かれるのを待っている Skill です

チームのコーディング規約を Claude に説明するたびに、あなたは同じことを繰り返しています。PR レビューのたびに、フィードバックをどのように構成してほしいかを説明し直しています。コミットメッセージのたびに、好みのフォーマットを Claude に伝え直しています。Skills はこれを解決します。

Skill とは、何かのやり方を一度だけ Claude に教える markdown ファイルです。Claude はその後、関連性がある場合に自動的にその知識を適用します。

Skills とは

Skills は、Claude Code がタスクをより正確に処理するために発見して使用できる、指示とリソースをまとめたフォルダです。各 Skill は、フロントマターに名前と説明を持つ SKILL.md ファイルに格納されています。

pr-review の SKILL.md がコードエディタで開かれており、ハードコードされたシークレットがないこと、Pydantic スキーマなどのレビューチェック項目が示されている。

description は、Claude が Skill を使用するかどうかを判断する方法です。PR のレビューを Claude に依頼すると、Claude はそのリクエストを利用可能な Skill の説明と照合し、関連するものを見つけます。Claude はあなたのリクエストを読み取り、利用可能なすべての Skill の説明と比較して、一致するものを有効化します。

Skill のフロントマターは次のようになります:

yaml
---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

フロントマターの下には、実際の指示を書きます — レビューチェックリスト、フォーマットの好み、そのタスクのために Claude が知っておくべきことなどです。

Skills はどこに配置されるか

Skills は、誰が必要とするかに応じて異なる場所に保存できます:

  • 個人用 Skills は ~/.claude/skills(ホームディレクトリ)に配置します。これらは、コミットメッセージのスタイル、ドキュメントのフォーマット、コードの説明のしかたなど、すべてのプロジェクトにわたって利用できます。
  • プロジェクト用 Skills は、リポジトリのルートディレクトリ内の .claude/skills に配置します。リポジトリをクローンした人は誰でも、自動的にこれらの Skills を利用できます。ここには、会社のブランドガイドライン、Web デザインで使う好みのフォントや色といった、チームの標準が置かれます。

Windows では、個人用 Skills は C:/Users/<your-user>/.claude/skills に配置されます。

プロジェクト用 Skills はコードと一緒にバージョン管理にコミットされるため、チーム全体で共有されます。

Skills と CLAUDE.md とスラッシュコマンドの比較

Claude Code には、動作をカスタマイズするいくつかの方法があります。Skills は、自動的でタスク固有であるという点で独特です。それぞれの比較は次のとおりです:

  • CLAUDE.md ファイルは、あらゆる会話に読み込まれます。Claude に常に TypeScript の strict モードを使ってほしい場合は、それを CLAUDE.md に記載します。
  • Skills は、リクエストに一致したときにオンデマンドで読み込まれます。Claude は最初は名前と説明だけを読み込むため、コンテキスト ウィンドウ全体を埋め尽くすことはありません。デバッグをしているときに PR レビューのチェックリストがコンテキストに含まれている必要はありません — 実際にレビューを依頼したときに読み込まれます。
  • スラッシュコマンド は、明示的に入力する必要があります。Skills にはそれが不要です。Claude は状況を認識すると、それらを適用します。

Claude がリクエストに Skill を一致させると、ターミナルにその読み込みが表示されます:

ブランチ sg-221 のプルリクエストをレビューするよう依頼した後、Skill pr-review の行に「Successfully loaded skill」と表示されている。

Skills を使うべきタイミング

Skills は、特定のタスクに適用される専門知識に対して最も効果を発揮します:

  • チームが従うコードレビューの基準
  • 好みのコミットメッセージのフォーマット
  • 組織のブランドガイドライン
  • 特定の種類のドキュメント用のテンプレート
  • 特定のフレームワーク用のデバッグチェックリスト

基本的なルールはシンプルです。同じことを Claude に繰り返し説明していることに気づいたら、それは書かれるのを待っている Skill です。

レッスンの振り返り

  • Claude Code との最近のやり取りを思い返してみてください。どの指示を繰り返していることに気づきましたか?Skill があれば、どのように時間を節約できたでしょうか?
  • チームのワークフローを考えてみてください。どの基準やプロセスを Skills として組み込むと、最も効果があるでしょうか?

次のステップ

次のレッスンでは、最初の Skill をゼロから作成し、Claude Code が裏側でどのように Skills を発見、一致、読み込みしているかを学びます。