Claude Code

Claude Code Skillsでワークフローを自動化する方法

Claude Code Skills 自動化

Claude Code Skillsで
ワークフローを自動化する方法

Claude Code Skillsは、よく使う操作やプロジェクト固有のワークフローを「スキル」として定義し、スラッシュコマンドで簡単に呼び出せる機能です。繰り返しの作業を自動化し、チーム全体の開発効率を大幅に向上させます。

この記事の対象者

  • Claude Codeを使い始めた開発者
  • 繰り返しの作業を自動化したい方
  • チームでClaude Codeの使い方を統一したい方

Skillsとは

Skillsは、Claude Codeの カスタムスラッシュコマンド を作る仕組みです。プロジェクトの .claude/skills/ ディレクトリにスキル定義ファイルを配置すると、Claude Code内で /スキル名 として呼び出せるようになります。

スキルを定義
/コマンドで呼び出し
Claudeが手順を実行

Skillsが解決する課題

  • 毎回同じ説明をする手間 — プロジェクトのデプロイ手順、コーディング規約などを毎回説明しなくて済む
  • チーム内での使い方のばらつき — スキルをGitで共有すれば全員が同じ手順で作業できる
  • 複雑な手順のミス — 多段階の操作を正確に再現できる

ディレクトリ構成

スキルは .claude/skills/ ディレクトリに配置します。

ディレクトリ構成
your-project/
├── .claude/
│   ├── CLAUDE.md            # プロジェクト設定
│   ├── settings.json        # Claude Code設定
│   └── skills/              # スキルディレクトリ
│       ├── deploy/
│       │   └── SKILL.md         # デプロイスキル
│       ├── create-model/
│       │   └── SKILL.md         # モデル作成スキル
│       └── review/
│           └── SKILL.md         # コードレビュースキル
└── src/
    └── ...
命名規則

スキルのディレクトリ名がそのままスラッシュコマンド名になります。例えば skills/deploy/ なら /deploy で呼び出せます。

スキルの作成方法

SKILL.mdの基本構成

各スキルディレクトリには SKILL.md ファイルを1つ配置します。このMarkdownファイルがスキルの定義そのものです。

.claude/skills/deploy/SKILL.md
# デプロイスキル

## 手順

1. テストを実行して全てパスすることを確認
2. mainブランチにマージ
3. docker compose build で本番イメージをビルド
4. docker compose up -d でデプロイ
5. ヘルスチェックを実行して正常稼働を確認

## 注意事項

- デプロイ前に必ずテストがパスしていることを確認する
- エラーが発生した場合はロールバック手順を案内する

SKILL.mdには自然言語で手順を記述します。Claudeがこの内容を読み取って、指示に従って作業を実行します。

スキルの呼び出し

Claude Code内での使用
$ claude

# スラッシュコマンドで呼び出し
> /deploy

# 引数も渡せる
> /deploy staging環境にデプロイしてください

実践的なスキル例

1. Djangoモデル作成スキル

.claude/skills/create-model/SKILL.md
# Djangoモデル作成

ユーザーの指示に基づいて Django モデルを作成する。

## 手順

1. 指定されたアプリの models.py にモデルクラスを追加
2. 適切なフィールドタイプを選択(CharField, IntegerField, ForeignKey等)
3. Meta クラスに verbose_name, ordering, indexes を設定
4. admin.py に ModelAdmin を登録
5. makemigrations & migrate を実行
6. 必要に応じてテストを作成

## 規約

- モデル名は PascalCase
- フィールド名は snake_case
- ForeignKey の related_name は必ず指定
- created_at, updated_at は全モデルに追加

2. コミットスキル

.claude/skills/commit/SKILL.md
# コミットスキル

変更内容を分析して、適切なコミットメッセージで Git コミットを作成する。

## コミットメッセージ規約

- feat: 新機能追加
- fix: バグ修正
- refactor: リファクタリング
- docs: ドキュメント更新
- test: テスト追加・修正

## フォーマット

```
<type>: <日本語で簡潔な説明>
```

## 手順

1. git diff で変更内容を確認
2. 変更の種類を判定(feat/fix/refactor等)
3. 日本語で簡潔なコミットメッセージを作成
4. git add で関連ファイルをステージング
5. git commit を実行

3. 記事作成スキル

.claude/skills/create-article/SKILL.md
# ブログ記事作成

Django の Article モデルにブログ記事を登録する。

## 手順

1. ユーザーのテーマに基づいて記事のHTMLコンテンツを生成
2. 適切な Classification を選択(なければ作成)
3. Django shell で Article.objects.create() を実行
4. 記事URLを確認して報告

## コンテンツ構成

- hero セクション(リード文)
- target-box(対象者)
- toc(目次)
- 本文(h2/h3 で構造化)
- code-block(コード例)
- info-box / warn-box(補足情報)
- summary-box(まとめ)

スキル設計のコツ

1. 具体的な手順を書く

曖昧な指示ではなく、Claudeが迷わない程度に具体的な手順を記述しましょう。

「適切にデプロイする」
「1. テスト実行 2. ビルド 3. デプロイ 4. ヘルスチェック」

2. 規約・制約を明記する

コーディング規約、命名規則、禁止事項などを明記すると、一貫性のあるコードが生成されます。

3. エラーハンドリングを含める

エラーが発生した場合の対処方法もスキルに含めておくと、Claudeが適切に対応できます。

4. Gitで共有する

.claude/skills/ ディレクトリをGitにコミットすれば、チーム全員が同じスキルを使えます。新しいメンバーのオンボーディングにも役立ちます。

スキルに含めないもの

APIキーやパスワードなどの機密情報はスキルに含めないでください。環境変数や .env ファイルを参照するように記述しましょう。

5. 小さく始める

最初から完璧なスキルを作ろうとせず、シンプルなスキルから始めて徐々に改善していくのがおすすめです。

まとめ
  • Skillsは .claude/skills/ にSKILL.mdを配置するだけで使えるカスタムコマンド
  • 繰り返しの作業(デプロイ、モデル作成、コミット等)を自動化できる
  • 自然言語で手順を記述するだけでClaudeが実行してくれる
  • Gitで共有すればチーム全体の開発効率が向上
  • 具体的な手順・規約を書き、小さく始めるのがコツ