Claude Code Skills 設定ガイド｜繰り返し作業を自動化
Claude Code Skills 自動化
Skills とは
Claude Code Skillsは、よく使うプロンプトや作業手順をテンプレートとして保存し、スラッシュコマンドで呼び出せる機能です。繰り返し行う作業を定型化することで、毎回同じ指示を入力する手間を省き、チーム全体で作業品質を統一できます。
Skills の仕組み
Skillsは、Markdownファイルとして.claude/skills/ディレクトリに保存されます。各ファイルがひとつのSkillに対応し、Claude Codeの会話中に/コマンドで呼び出せます。
.claude/
skills/
review.md
test.md
refactor.mdSkills ファイルの作成方法
基本構造
Skillファイルは通常のMarkdownで記述します。ファイル名がスラッシュコマンド名になります。
# コードレビュー
以下の観点でコードをレビューしてください：
1. バグの可能性がある箇所
2. パフォーマンスの改善点
3. セキュリティ上の懸念
4. 可読性・保守性の改善点
問題を見つけた場合は、具体的な修正案も提示してください。このファイルを.claude/skills/review.mdとして保存すると、Claude Code内で/reviewと入力するだけで呼び出せます。
引数を使ったSkill
Skillにはコンテキスト情報を渡すこともできます。
# テスト生成
指定されたファイルに対して、以下の方針でユニットテストを作成してください：
- テストフレームワーク: vitest
- 正常系・異常系の両方をカバー
- エッジケースも考慮する
- モックは最小限に抑える
- テストの説明は日本語で記述する実践的なSkill例
1. コミットメッセージ生成
# コミットメッセージ
変更内容を分析し、Conventional Commits形式でコミットメッセージを作成してください。
形式: <type>(<scope>): <description>
typeは以下から選択:
- feat: 新機能
- fix: バグ修正
- docs: ドキュメント
- refactor: リファクタリング
- test: テスト追加・修正
- chore: その他
日本語の説明も併記してください。2. API エンドポイント作成
# API作成
以下の規約に従ってRESTful APIエンドポイントを作成してください：
- フレームワーク: Hono
- バリデーション: zod
- エラーハンドリング: 統一的なエラーレスポンス形式
- レスポンス形式: { data, error, meta }
- 適切なHTTPステータスコードを返す3. リファクタリング
# リファクタリング
指定されたコードを以下の方針でリファクタリングしてください：
- 関数は単一責任の原則に従う
- 変数名・関数名は意図が明確なものにする
- マジックナンバーは定数に置き換える
- 重複コードを共通化する
- 型定義を厳密にする
変更前後の差分を説明し、なぜその変更が有効かも述べてください。4. ドキュメント生成
# ドキュメント
指定されたコードのドキュメントを作成してください：
- JSDoc形式のコメントを追加
- 関数の目的・引数・戻り値を明記
- 使用例（@example）を含める
- 複雑なロジックにはインラインコメントを追加チームでの共有
.claude/skills/ディレクトリをGitリポジトリに含めることで、チーム全員が同じSkillsを利用できます。
# .gitignoreでskillsディレクトリを除外しない
git add .claude/skills/
git commit -m "feat: Claude Code Skillsを追加"これにより、コードレビューの観点やテストの方針などをチームで統一できます。
Skills を効果的に使うコツ
- 具体的に書く: 曖昧な指示ではなく、具体的な基準やフォーマットを指定する
- プロジェクト固有のルールを含める: 使用するフレームワークや命名規則を明記する
- 段階的に改善する: 最初は簡単なSkillから始めて、使いながら精度を高める
- CLAUDE.mdとの併用: プロジェクト全体のルールはCLAUDE.mdに、タスク固有の手順はSkillsに分ける
まとめ
Claude Code Skillsは、AIとの作業を効率化する強力な機能です。チームの開発規約やよく行う作業をSkillとして定義しておけば、一貫した品質のアウトプットを素早く得られます。まずは日常的に繰り返している作業をひとつSkill化するところから始めてみましょう。Claude Codeの全体像を知りたい方は使い方 完全ガイドを、外部ツールとの連携に興味がある方はMCP接続方法もご覧ください。