AI・テクノロジー

Claude Codeのスキル（/skill）とは？カスタムコマンドを作って作業を自動化する方法

6 min readryusei_ueda

Claude Code には「スキル（skill）」と呼ばれる機能があります。よく使う作業手順をMarkdownファイルに書いておくと、/skill名 と入力するだけで Claude がその手順に従って動いてくれます。

この記事では、スキルとは何か・どう作るか・どう使うかを初心者向けに解説します。

この記事でわかること

  • スキル（/skill）とは何か、何が便利なのか
  • スキルの作り方（フォルダ構成・ファイルの書き方）
  • スキルの呼び出し方と実際の動き
  • スキル活用のアイデア例

スキルとは？

Claude Code
Claude Code のカスタマイズ機能のひとつがスキル

スキルとは、Claude Code に覚えさせるカスタム作業手順です。たとえば「ブログ記事を書いてデプロイするまでの手順」を1つのスキルとして定義しておけば、/blog-creator と入力するだけで Claude がその手順通りに動いてくれます。

スキルなしスキルあり
毎回「ブログを書いて、画像を取得して、ファイルを更新して、ビルドして、PR出して…」と説明する/blog-creator テーマ名 と入力するだけ

スキルを作る：フォルダ構成

スキルは ~/.claude/skills/ ディレクトリに保存します。スキルごとにフォルダを作り、その中に skill.md ファイルを置きます。

~/.claude/
└── skills/
    ├── blog-creator/
    │   └── skill.md
    ├── code-review/
    │   └── skill.md
    └── release-notes/
        └── skill.md

スキルファイルの書き方

skill.md の基本構成は以下の通りです。

---
name: スキル名（英字ケバブケース）
description: "このスキルが何をするか、いつ使うかの説明（Claude がスキルを選ぶ判断基準になる）"
---

# スキルのタイトル

## 手順

### Step 1: ...
...

### Step 2: ...
...

具体例：コードレビュースキル

---
name: code-review
description: "コードレビューを依頼されたとき。品質・セキュリティ・パフォーマンスの観点でレビューする。"
---

# コードレビュースキル

## レビュー手順

1. 対象ファイルを確認する
2. 以下の観点でチェックする：
   - バグ・エッジケースの見落とし
   - セキュリティリスク（SQL インジェクション・XSS など）
   - パフォーマンス（不要な再レンダリング・N+1 クエリなど）
   - 可読性・命名の適切さ
3. 問題点を重大度（High / Medium / Low）付きで列挙する
4. 修正案のコードを提示する

スキルの呼び出し方

Claude Code ドキュメント
スキルは /スキル名 で呼び出す。引数も渡せる。

Claude Code のチャット欄で /スキル名 と入力するだけです。

# スキルを呼び出す
/code-review

# 引数（対象ファイルなど）も渡せる
/code-review src/components/Header.tsx

# スキル一覧を確認する
/help

Claude がスキルファイルを読み込み、定義した手順に従って作業を進めてくれます。

スキル活用のアイデア例

スキル名やること
/blog-creatorブログ記事を書いてデプロイまで行う
/code-review指定ファイルをセキュリティ・品質観点でレビュー
/release-notesgit log からリリースノートを自動生成
/pr-creator変更内容からPRタイトル・説明文を生成してPRを作成
/test-writer指定関数のユニットテストを作成
/translate-docsREADMEや仕様書を日本語に翻訳

よくある質問

Q. スキルファイルはどこに置けばいいですか？

~/.claude/skills/スキル名/skill.md に置きます。グローバルに有効なため、どのプロジェクトでも使えます。プロジェクト固有のスキルは .claude/skills/（プロジェクトルート直下）に置くことで、そのプロジェクトだけに適用できます。

Q. スキルを追加したらすぐ使えますか？

Claude Code を再起動しなくても、次のメッセージ送信時から有効になります。ただし、セッションを /clear でリセットすると確実に反映されます。

Q. スキルと CLAUDE.md の違いは何ですか？

CLAUDE.md はプロジェクトのルールや技術スタックを常時読み込む「コンテキスト」です。スキルは「特定の作業フロー」を定義したもので、/スキル名 で明示的に呼び出すときだけ使われます。用途に応じて使い分けましょう。

まとめ

  1. スキルは ~/.claude/skills/スキル名/skill.md に Markdown で手順を書くだけで作れる
  2. チャット欄で /スキル名 と入力するだけで呼び出せる
  3. ブログ作成・コードレビュー・PR作成など繰り返し作業をスキル化すると効率が大幅に上がる
  4. グローバル（~/.claude/skills/）とプロジェクト固有（.claude/skills/）の2種類がある
  5. まずは自分がよく使う作業フローを1つスキル化するところから始めよう