Skills（スキル）とは？Claude Codeで手順を再利用する仕組み

Skillsは、手順・判断基準・補助資料をClaude Codeに渡すための拡張です。スキルのフォルダにSKILL.mdを置き、必要ならreferences/やexamples/を同梱します。スキルは状況に応じて自動利用されるほか、/skill-nameで明示的に呼び出せます。昔の.claude/commands/name.mdもスラッシュコマンドとして動作しますが、新しく作るならSkillsの構成が扱いやすいです。

CLAUDE.mdとの違い

置く内容を役割で分けます。

• CLAUDE.mdプロジェクトの常設ルール。使う道具や基本の検査方法。
• Skill必要なときに使う手順。記事レビューなど特定の作業。

Skillを呼び出した後は、どの手順を読み、どの成果物を作ったかを確認します。

CLAUDE.mdは毎回読み込むプロジェクトの常設ルールです。「pnpmを使う」「テスト前に差分を見る」のような短い事実を置きます。Skillは必要な時だけ読み込む手順書なので、記事レビューやリリース手順など、繰り返し使うが毎回は不要な情報に向きます。MCPは外部サービスへの接続、Hookはイベント発生時の決まった処理です。

最小構成

.claude/skills/article-review/SKILL.md

---
name: article-review
description: 公式資料を照合して日本語記事をレビューするときに使う
---
# 記事レビュー
1. 対象URLと確認日を記録する。
2. 公式資料でコマンドと制限を確認する。
3. 変更点、未確認点、次の検証を分けて出力する。

プロジェクト用は.claude/skills/、全プロジェクト用はユーザーのClaude設定ディレクトリ配下です。プラグイン内のSkillは名前空間付きで表示され、同名の衝突を避けます。descriptionは「いつ使うか」を具体的に書き、秘密情報や長大なログを埋め込まないでください。

使う前の確認

まずclaude --versionと/helpで環境を確認し、スキル名が/の候補に出るかを見ます。自動選択に任せる場合でも、最終的にどの手順を読んだか、作成されたファイルとコマンドを確認します。スキルはモデルへの指示であり、実行結果を保証するものではありません。書き込みを含む手順では対象ディレクトリと許可範囲を明記します。

詳しい作成例はスキルを作って繰り返し作業を自動化する、配布する段階はPluginの作成を参照してください。

公式のSkillsガイドと拡張機能の全体像を2026年9月10日に確認しました。実機検証はしていません。