Claude Code には「スキル（Skill）」という仕組みがあります。よく使う手順やプロンプトをMarkdownファイルに書いておくだけで、/コマンド名 の形で呼び出せるようになります。

この記事では、スキルの仕組みから作成手順・実用例まで、丁寧に解説します。

スポンサーリンク

目次

1. スキルとは何か
2. スキルファイルの置き場所
3. スキルファイルの構造
4. スキルを作成する手順
5. スキルの呼び出し方
6. 実用スキルの例
7. スキル作成のコツ
8. まとめ

1. スキルとは何か

Claude Code のスキルは、繰り返し実行したい作業をMarkdownファイルに定義したカスタムコマンドです。

たとえば次のような操作をスキルとして登録できます。

• コードレビューの手順
• Gitコミットメッセージの自動生成
• WordPress記事の投稿フロー
• 特定のファイル形式への変換処理
• テストを実行してレポートを出力する

2. スキルファイルの置き場所

3. スキルファイルの構造

スキルファイルは Markdown形式（.md） で記述します。ファイル名がそのままコマンド名になります。

例えば commit.md というファイルを作ると、/commit というコマンドで呼び出せます。

基本構造

# スキルのタイトル（見出しがスキルの説明として表示される）

スキルが呼ばれたときにClaudeが実行する指示を
ここに自然言語で書きます。

## 手順

1. まず〇〇を確認する
2. 次に〇〇を実行する
3. 結果を報告する

## 注意事項

- 〇〇の場合は〇〇する
- エラーが出たら〇〇を試みる

フロントマター付きの例

---
description: Gitコミットを作成するスキル
trigger: ユーザーがコミットを作成したいとき、変更を保存したいとき
---

# コミット作成スキル

以下の手順でGitコミットを作成してください。

1. `git status` で変更ファイルを確認する
2. `git diff` で変更内容を確認する
3. 変更の意図に合ったコミットメッセージを日本語で作成する
4. `git add` で関連ファイルをステージングする
5. `git commit` でコミットを作成する

## 注意事項

- コミットメッセージは「何をしたか」より「なぜしたか」を重視する
- 無関係なファイルをまとめてコミットしない

4. スキルを作成する手順

# ユーザー共通スキルの場合
mkdir -p ~/.claude/skills

# プロジェクト固有の場合（プロジェクトルートで実行）
mkdir -p .claude/skills

# 例：review.md というスキルを作成
touch ~/.claude/skills/review.md
# または
code ~/.claude/skills/review.md

# コードレビュースキルの例（review.md）

---
description: コードの品質レビューを行うスキル
---

# コードレビュー

変更されたコードを以下の観点でレビューしてください。

## チェック項目

1. **バグ・ロジックエラー** - 処理の誤りや考慮漏れがないか
2. **セキュリティ** - SQLインジェクション、XSS等の脆弱性がないか
3. **パフォーマンス** - 無駄なループや重複処理がないか
4. **可読性** - 変数名・関数名が適切で理解しやすいか
5. **テスト** - テストが書かれているか、カバレッジは十分か

## 出力形式

- 問題点は重要度（高・中・低）を付けてリストアップする
- 良い点も必ず1〜3つ挙げる
- 修正が必要な箇所はコード例を示す

5. スキルの呼び出し方

スキルは /ファイル名（拡張子なし） で呼び出します。

# review.md を呼び出す場合
/review

# commit.md を呼び出す場合
/commit

# 引数を渡すこともできる
/review src/components/Button.tsx

# スキルに説明テキストを追加して呼び出す
/commit -m "ユーザー認証機能を追加"

6. 実用スキルの例

例1: 日報作成スキル（daily-report.md）

---
description: 今日の作業内容から日報を自動生成する
---

# 日報作成スキル

今日のGitコミット履歴と変更内容を分析して、日報を作成してください。

## 手順

1. `git log --since="today" --oneline` で本日のコミットを取得する
2. コミット内容を業務カテゴリに分類する（開発・レビュー・調査・会議等）
3. 以下のフォーマットで日報を出力する

## 出力フォーマット

【本日の作業】
- 〇〇機能の実装（2時間）
- コードレビュー（1時間）

【完了タスク】
- チケット番号とタスク名

【明日の予定】
- 継続中のタスクを自動提案

【所感・連絡事項】
（空欄でユーザーが記入）

例2: README自動生成スキル（readme.md）

---
description: プロジェクトのREADMEを自動生成する
---

# README自動生成スキル

このプロジェクトのコード構成を分析して、適切なREADMEを生成してください。

## 含める内容

1. プロジェクト概要（package.jsonや主要ファイルから推測）
2. 必要な環境・前提条件
3. インストール手順
4. 使い方（主要なコマンドやAPIエンドポイント）
5. ディレクトリ構成
6. ライセンス

## 注意

- 日本語で書く
- コードブロックは必ずシンタックスハイライト付きで記述する
- 既存のREADMEがある場合は内容を保持しつつ補完する

例3: デプロイ前チェックスキル（pre-deploy.md）

---
description: デプロイ前の最終確認チェックリストを実行する
---

# デプロイ前チェック

本番環境へのデプロイ前に以下を確認してください。

## 自動チェック項目

1. テストを実行する（`npm test` または `pytest`）
2. Lintエラーがないか確認する
3. 環境変数ファイル（.env）がgitignoreに含まれているか確認する
4. package.jsonのバージョンが適切か確認する
5. 未コミットの変更がないか確認する（`git status`）

## 確認後の報告形式

✅ チェック通過 / ❌ 要対応

各項目の結果をまとめて報告し、❌がある場合は対処法を提示する。

7. スキル作成のコツ

コツ1: 手順は番号付きリストで書く

Claudeはステップが明確な指示に従いやすい傾向があります。「まず〇〇、次に〇〇」という流れを番号付きで記述すると精度が上がります。

コツ2: 出力フォーマットを明示する

スキルの実行結果をどういう形式で出力してほしいかを具体的に書きましょう。表・箇条書き・コードブロックなど、用途に合った形式を指定します。

コツ3: 注意事項・例外処理を書く

「〇〇の場合はスキップする」「エラーが出た場合は〇〇を試みる」など、想定される例外ケースを書いておくと、予期しない挙動を減らせます。

コツ4: 引数（ARGUMENTS）を活用する

スキル呼び出し時に渡されたテキストは ARGUMENTS という変数で参照できます。スキルファイルの中で ARGUMENTS と記述すると、呼び出し時の追加テキストを受け取れます。

# スキル呼び出し例
/review 対象ファイル: src/api/users.ts　重点: セキュリティ

# スキルファイル内での参照
ARGUMENTS: {{ユーザーが渡した追加指示をここに適用する}}

コツ5: 既存スキルを参考にする

Claude Code にはあらかじめ組み込まれたスキルがあります（/commit、/help など）。~/.claude/skills/ にある既存ファイルを参考にしながら自分のスキルを作ると効率的です。

Claude Codeのスキル機能を活用して、日々の繰り返し作業を自動化していきましょう。一度作ったスキルはチームで共有することもできるので、ナレッジの蓄積にも役立ちます。