skip to content
one more think
Table of Contents

Claude Codeのスキルは、開発作業の手順そのものをコマンドとして保存する仕組み。使う人が育てていくものだという話。


前回の記事(Claude web編)では、Claude.aiのブラウザ画面で使えるスキルを紹介しました。今回は開発者向け、Claude Code(ターミナルやエディタの上で動くAIの道具)でのスキルの活用方法です。

Claude Codeを使い始めると、最初は「AIとのチャット」のように使うことが多いと思います。でも、スキルとサブエージェントの仕組みを理解すると、ひとつ上の使い方ができるようになります。

Claude Codeにおけるスキルとは

Claude Codeのスキルは、繰り返し使う指示を「スラッシュコマンド(/コマンド名)」として登録・呼び出す仕組みです。

ウェブ版のスキルがブラウザ上のAIアシスタントをカスタマイズするものだとすれば、Claude Codeのスキルは「開発作業の手順そのものをコマンドとして保存する」もの。

たとえば「このプロジェクトのコードレビューをして」「変更内容を検証して動作確認して」といった作業を、毎回文章で指示するのではなく /code-review /verify のように呼び出せます。

技術的には、プロジェクト直下の .claude/commands/ フォルダ(またはすべてのプロジェクトで使える ~/.claude/commands/)にMarkdownファイルを置くことで、独自のスラッシュコマンドとして登録できます。

標準で使えるスキル

Claude Codeには、あらかじめ便利なスキルが用意されています。主なものを。

開発の流れに沿ったもの

コマンド内容
/code-review現在の差分をレビューしてバグや改善点を指摘する
/verify変更をアプリ上で実際に動かして動作確認する
/simplifyコードを整理する
/runプロジェクトのアプリを起動して挙動を確認する
/security-reviewセキュリティ上の問題を確認する

設定・管理

コマンド内容
/initCLAUDE.md(プロジェクトの設定ファイル)を初期化する
/update-configClaude Codeの設定を調整する
/fewer-permission-promptsよく使うコマンドの許可を自動設定して確認を減らす

繰り返し実行

コマンド内容
/loop指定した指示やコマンドを繰り返し実行する
/scheduleクラウド上で定期実行するエージェントを設定する

これらはインストールした時点から使えます。まずはこの標準のスキルを一通り試してみるだけで、作業効率はかなり変わります。

独自スキルの作り方

プロジェクトに特化したスキルを自分で作ることもできます。手順はシンプル。

1. ファイルを置く場所を決める

  • .claude/commands/my-skill.md:そのプロジェクトだけで使うスキル
  • ~/.claude/commands/my-skill.md:すべてのプロジェクトで使えるスキル

2. Markdownファイルを書く

ファイルの中身は、Claudeへの指示をMarkdownで書くだけです。

---
description: 変更ファイルのテストを実行して結果を報告する
---
以下の手順でテストを実行してください。
1. git diff で変更されたファイルを確認する
2. 変更に関連するテストファイルを特定する
3. テストを実行して結果を報告する
4. 失敗したテストがあれば原因を分析する

3. 呼び出す

Claude Codeのターミナルで /my-skill と入力するだけ。ファイル名がそのままコマンド名になります。

サブエージェントと組み合わせる

スキルと並んで理解しておきたいのが「サブエージェント」という考え方です。

通常のClaude Codeは、ひとつのAIが順番に作業をこなします。これに対してサブエージェントは、メインのClaudeが「別のAIに仕事を依頼する」仕組み。人間で言えば、プロジェクトマネージャーが複数の担当者に仕事を割り振るようなイメージです。

Claude Codeでは、スキルの指示の中にサブエージェントの起動を組み込めます。たとえばコードレビューのスキルに「セキュリティの観点で確認する担当」と「性能の観点で確認する担当」を並行で走らせる、という設定が可能です。

サブエージェントの種類

エージェント得意なこと
Exploreファイルやコードの高速な検索・調査
Plan実装方針の設計・整理
general-purpose複数の手順にまたがる作業

サブエージェントの最大の利点は、複数の調査や確認を同時に走らせられることです。「フロントエンド側のレビュー」と「バックエンド側のレビュー」を順番ではなく並行して実行するスキルを作ると、レビューにかかる時間を大幅に短縮できます。

ただし、サブエージェントを起動するほど処理のコストも増えます。複雑な作業に使う一方で、シンプルな作業はひとつのエージェントで完結させる、という使い分けが現実的かなと。

ウェブ版との違い

ウェブ版のスキルとClaude Codeのスキルは、目的が異なります。

ウェブ版スキルClaude Codeスキル
使う場面文書作成・情報整理・コミュニケーションコーディング・テスト・デプロイ
設定の保存先Claude.aiのアカウント上.claude/commands/ フォルダ
呼び出し方スキル一覧から選ぶ/コマンド名
チームでの共有アカウント単位Gitリポジトリで共有可能
サブエージェント連携なしあり

Claude Codeのスキルの特徴は、Markdownファイルをリポジトリに入れてGitで管理できる点です。チーム全員が同じスキルを使えるようになるため、「この人のレビューは毎回ポイントを押さえている」というような個人差を、ある程度吸収できます。

実務での使い方

私が試しているパターンをいくつか。

毎朝のコードレビュー準備

前日からの差分に対して /code-review を実行して、「自分でレビューする前にAIが一度通す」という流れを作ると、明らかな問題の見落としが減ります。

リリース前の確認チェックリスト

「本番反映前に確認すること」をスキルにまとめておいて、デプロイ前に毎回 /pre-deploy-check を実行する。チェック漏れを防ぐ習慣として機能します。

CLAUDE.mdを育てる

/init でプロジェクトのCLAUDE.mdを初期化した後、気づいたことを随時書き足していくことで、Claudeがそのプロジェクトの文脈をより深く理解するようになります。これ自体が、スキルを育てることにつながります。

まずは2つから

Claude Codeを使い始めたばかりの方には、まず /init/code-review の2つから試してみることをおすすめします。

/init でプロジェクトの概要をCLAUDE.mdに記録し、その後 /code-review で変更をレビューする。この2ステップを習慣にするだけで、Claude Codeとの付き合い方の質がぐっと上がります。

スキルは「使う人が育てる」仕組みです。最初から完璧なものを用意しようとせず、実際に動かしながら「この指示が足りなかった」「この出力は使いにくい」を積み重ねていく。サブエージェントも同様で、シンプルな使い方から始めて少しずつ組み合わせを試していくのが、無理なく定着させるやり方なのではないかなと思っています。