スキルの作成

Claude Code によるソフトウェア開発

Dani Zysman

AI Curriculum Manager @ DataCamp

スキルとは？

ラベル付きの指示カードが入ったツールボックス

再利用可能な指示 - 必要に応じて Claude が従う
一度定義すれば、どこでも使用可能
/skill-name で呼び出す、または自動実行

スキルとしてのユニットテスト

関数を単独でテストするユニットテストの概念

スキルの保存場所

個人用スキル（すべてのプロジェクト）：

~/.claude/
  /skills/
    /my-skill/
      SKILL.md

プロジェクト用スキル（このプロジェクト）：

project/
  /.claude/
    /skills/
      /unit-tests/
        SKILL.md

SKILL.md の構造

___
# SKILL.md
name: unit-tests
description: Generate pytest unit tests for Python functions
___

When asked to write unit tests:
1. Identify the function's inputs and outputs
2. Write tests for normal cases first
3. Add edge cases (empty input, invalid data)
4. Use descriptive test names
5. Run pytest to verify tests pass

フロントマター = name + description | 本文 = 段階的な手順

スキルを手動で作成する

スキル作成の手順：

プロジェクトのルートディレクトリで新しいフォルダを作成：mkdir -p .claude/skills/unit-tests
ファイルを開く：code .claude/skills/unit-tests/SKILL.md（または任意のエディタ）
フロントマターと指示を記述または貼り付け
ファイルを保存
claude を起動し、/skills でスキルが利用可能か確認

ここまでのプロジェクト

music-analytics-api/
  app.py
  routes.py
  models.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md
    skills/              # <- Skills folder
      unit-tests/
        SKILL.md

スキルを使うタイミング

スキルに向いているケース：
- 一貫した手順の繰り返しワークフロー
- 徹底すべきチームのコーディング規約
- 再現性が必要な複数ステップのワークフロー
- 毎回従うべきパターン

スキルに向いていないケース：
- 一度限りのタスク
- コードに関する簡単な質問
- 毎回大きく異なるタスク
- ファイルの簡単な検索

スキル vs. エージェント

項目	スキル	エージェント
概要	Claude が従う指示	専門のアシスタント
動作方法	Claude が手順を実行	エージェントが自律的に作業
場所	`.claude/skills/`	`.claude/agents/`
呼び出し方法	`/skill-name` または自動	`@agent-name` または自動

どちらも Claude Code を拡張します。ワークフローにはスキル、専門知識にはエージェントを使用しましょう

エージェントとスキルの連携

アクセス可能なスキルを宣言するエージェントファイル

練習しましょう！

Claude Code によるソフトウェア開発