💻 Claude Code入門 📖 約15分で読めます

Claude CodeのSkills機能入門 ― カスタムコマンドで作業を効率化

組み込みスキルからカスタムワークフローまで完全ガイド

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

無料で学習を始めるクロガイドとは？

はじめに

Claude Codeには「Skills（スキル）」と呼ばれるカスタムコマンド機能が搭載されています。よく行う操作をスキルとして定義しておけば、ワンコマンドで複雑なワークフローを実行でき、作業効率が大幅に向上します。

この記事では、組み込みスキルの活用方法からスキルの仕組み、カスタムワークフローの構築までを実践的に解説します。

Skillsとは何か
組み込みスキル一覧と使い方
スキルの仕組み
利用可能なスキルの確認方法
スキルの引数
スキル vs 自然言語の使い分け
スキルを使ったワークフロー構築
まとめ

Skillsとは何か

SkillsはClaude Codeの拡張機能で、特定のタスクを定型化して繰り返し実行できるようにする仕組みです。シェルスクリプトのエイリアスやIDEのコードスニペットに近い概念です。

Skillsの特徴

再現性：同じ操作を毎回一貫した方法で実行できる
効率性：複数ステップの操作をワンコマンドで実行
共有可能：チームメンバーと共有してワークフローを標準化
カスタマイズ可能：プロジェクトに合わせた独自スキルを作成

スキルの種類

種類	説明	例
組み込みスキル	Claude Codeに標準搭載されたスキル	/init, /compact, /review, /memory
バンドルスキル	公式提供のスキルパッケージ	/simplify, /batch, /debug, /claude-api
カスタムスキル	ユーザーが定義したスキル（.claude/skills/ 配下のSKILL.md）	/deploy, /format, /create-component

組み込みスキル一覧と使い方

Claude Codeにはいくつかの組み込みスキルが用意されています。

/simplify ― コード品質レビュー

使い方

# コードの品質をレビューし、簡潔にするための提案を行う
/simplify

# 引数付き：対象を指定
/simplify src/utils/helpers.ts

動作の流れ

指定されたコードを分析
複雑なロジックや冗長な部分を特定
シンプルで可読性の高いコードへの改善案を提示
リファクタリングの提案を実行

コミットを作成するには

コミット作成はスキルではなく、CLIコマンドまたは自然言語で行います。

# CLIから直接コミット（非対話モード）
claude commit

# 対話中に自然言語で指示
> 変更をコミットしてください

/review ― コードレビュー

使い方

# PRの変更をレビュー
/review

# 特定のPRをレビュー
/review 123

レビューで確認される項目

コードの品質と可読性
潜在的なバグやセキュリティの問題
テストの妥当性
プロジェクトの規約への適合

/batch ― 大規模並列変更

使い方

# 大量のファイルに対して同じ変更を並列に適用
/batch すべてのテストファイルにdescribeブロックを追加

# 対象を限定して実行
/batch src/components/*.tsx にaria-labelを追加

複数のファイルに同種の変更を一括で適用したい場合に便利です。サブエージェントを使って並列処理を行います。

/debug ― トラブルシューティング

使い方

# 現在のセッションの問題をデバッグ
/debug

# 特定のエラーについて調査
/debug TypeError: Cannot read property of undefined

エラーやバグの原因を体系的に調査し、解決策を提案します。

/claude-api ― APIリファレンス

使い方

# Claude APIの使い方を参照
/claude-api

# 特定のトピックについて
/claude-api streaming responses

Anthropic Claude APIのリファレンス情報を参照できます。

/init ― プロジェクト初期化

使い方

# CLAUDE.mdの生成
/init

# プロジェクトを分析してCLAUDE.mdを自動生成する

プロジェクトのディレクトリ構造、使用技術、設定ファイルなどを分析し、適切なCLAUDE.mdを自動生成します。

その他の組み込みコマンド

コマンド	機能	使用場面
/compact	会話履歴の圧縮	コンテキストが枯渇してきたとき
/cost	トークン消費量の確認	コスト管理
/clear	会話履歴のクリア	完全に新しい話題に切り替えるとき
/help	ヘルプの表示	使い方がわからないとき
/memory	メモリの管理	セッション間の情報保持

スキルの仕組み

スキルの内部動作を理解すると、より効果的に活用できます。

スキル実行の流れ

コマンド解析：/skill-name [args]の形式を認識
スキル定義の読み込み：対応するスキルのMarkdownファイルを読み込み
プロンプト構築：スキル定義＋引数＋現在のコンテキストからプロンプトを構築
実行：構築されたプロンプトに基づいてAIが作業を実行
結果の表示：実行結果をユーザーに表示

つまりスキルの本質は「事前に定義されたプロンプトテンプレート」です。スキルを呼び出すと、テンプレートに引数が埋め込まれ、Claude Codeが一連の作業を自動で行います。

スキル定義ファイルの場所

プロジェクトスキル（推奨）：.claude/skills/<skill-name>/SKILL.md ― YAMLフロントマター対応の公式形式
レガシー形式：.claude/commands/ ディレクトリ内のMarkdownファイル（引き続き動作するが、skillsが優先される）
ユーザースキル：~/.claude/skills/<skill-name>/SKILL.md または ~/.claude/commands/
組み込み・バンドルスキル：Claude Code本体に内蔵

利用可能なスキルの確認方法

現在のセッションで使えるスキルを確認する方法を紹介します。

# スラッシュを入力するとオートコンプリートでスキル一覧が表示される
/

# ヘルプでコマンド一覧を確認
/help

スキル一覧の見方

# /と入力した際の表示例
/simplify      - コード品質レビューと改善提案
/batch         - 大規模な並列変更を実行
/debug         - トラブルシューティング
/claude-api    - Claude APIリファレンス
/review        - コードレビューを実行
/init          - CLAUDE.mdを生成
/compact       - 会話を圧縮
/deploy        - (カスタム) デプロイを実行  ← 自分で追加したスキル

スキルの引数

多くのスキルは引数を受け取ることができます。引数の渡し方にはいくつかのパターンがあります。

引数のパターン

# 位置引数（スキル名の後にスペース区切り）
/simplify src/utils/helpers.ts

# 変数展開（$ARGSプレースホルダー）
# スキル定義内で $ARGUMENTS, $ARGUMENTS[0], $1 等としてアクセス可能
/create-component UserProfile

# 複数の引数
/deploy staging --skip-tests

カスタムスキルでの引数の使い方

# .claude/skills/create-component/SKILL.md の内容例
---
name: create-component
description: Reactコンポーネントを生成する
argument-hint: コンポーネント名
allowed-tools: Read, Write, Glob
---

以下の名前でReactコンポーネントを作成してください: $ARGUMENTS

要件：
- TypeScript (.tsx)
- Props型定義を含める
- デフォルトexport
- 基本的なテストファイルも生成

スキル vs 自然言語の使い分け

同じことを自然言語でも指示できますが、スキルを使うべき場面があります。

場面	スキルが適切	自然言語が適切
繰り返し行う定型作業	毎回同じ品質で実行	-
チームで統一したい操作	全員が同じ手順を実行	-
複雑な手順がある作業	手順の漏れを防ぐ	-
一回限りの特殊なタスク	-	柔軟に対応できる
要件が毎回異なる作業	-	状況に応じて指示を変えられる
探索的な作業	-	対話しながら方針を決められる

判断の目安

「3回以上同じ指示を書いたら、スキルにする」が良いルールです。定型化できる部分はスキルに、創造性が必要な部分は自然言語で指示しましょう。

スキルを使ったワークフロー構築

複数のスキルや操作を組み合わせて、開発ワークフローを構築できます。

ワークフロー例1: 機能開発フロー

/init でプロジェクトの理解を更新（初回のみ）
自然言語で機能を実装
/review で自分のコードをセルフレビュー
レビュー指摘を修正
claude commit または「コミットしてください」で適切なメッセージでコミット

ワークフロー例2: バグ修正フロー

バグの症状を自然言語で伝え、原因を調査
修正を実装
テストを追加して再現確認
「fix: 形式でコミットしてください」と指示してコミット

ワークフロー例3: 朝の開発開始ルーティン

# 1. 前回のセッションを確認
claude --continue

# 2. またはTODOを確認
> CLAUDE.mdのTODOセクションを読んで、今日やるべきことを教えて

# 3. 作業開始
> [TODO項目]を実装してください

# 4. 作業完了後
> 変更をコミットしてください
> CLAUDE.mdのTODOを更新してください

まとめ

Claude CodeのSkills機能のポイントを振り返ります。

Skillsの本質：定型化されたプロンプトテンプレートで、再現性のある操作を効率的に実行
組み込み・バンドルスキル：/simplify, /batch, /debug, /claude-api, /review, /init, /compact など基本操作をカバー
カスタムスキル：.claude/skills/<skill-name>/SKILL.mdにYAMLフロントマター付きで独自スキルを定義（.claude/commands/も引き続き利用可能）
引数：$ARGUMENTSプレースホルダーでスキルにパラメータを渡せる
使い分け：繰り返す定型作業はスキル、一回限りの作業は自然言語
ワークフロー：スキルと自然言語を組み合わせて効率的な開発フローを構築

まずは/simplifyと/reviewを日常的に使うことから始めて、慣れてきたら独自のカスタムスキルを作ってみましょう。