Claude Skills 入門

アジェンダ

使い方の前に、まずSkillsが解決しようとしている課題と他の選択肢との位置付けを整理する。その後で実際に手を動かし、最後に発展トピックを押さえる。

Skills の概要

Skills とは、AIエージェントに与える外部コンテキストの表現形式・およびその運用を定義した新しい標準です。Skills の実体は .md などのコンテキストを所定の形式で配置したフォルダです。AIに事前に与えられる情報は「スキルの全体像」のみであり、必要に応じて詳細を確認します。スキルはAI自身が作ることも可能。

他の文脈付与手法との比較

Skills は MCP・RAG・カスタム指示と並ぶ「AIに文脈を渡す手段」のひとつ。3つの代表的な手法を、文脈の所在・呼び出し方・更新主体の観点から比較する。

スキルの典型的なフォーマット

スキルを作成・配置する際に必須で守る必要があるのは、① AIが想定している場所に格納すること、② スキル名をスネークケースで書くこと、③ SKILL.md を格納すること。スキルはフォルダで管理され、上記の制約以外は何を格納するかなどは自由です。

skills              ─ スキル全体を格納（CC なら ~/.claude、Cursorなら ~/.cursor 配下）
└── skill-name      ─ スキル名はスネークケース（小文字＋数字＋ハイフン）
    ├── SKILL.md    ─ メタデータと指示内容
    ├── references/ ─ ドキュメント
    ├── scripts/    ─ 実行可能なコード
    └── ...

---
name: modern-python-dev
description: 現代的な Python 開発環境のセットアップを担当する。Ruff/UV/pre-commit/pytest を組み合わせて、ベストプラクティスのプロジェクト構成（pyproject.toml ベース、テストランナー込み）を整える。

---

# Modern Python Dev

このスキルは uv + ruff + mypy + pre-commit を使った Python 開発環境テンプレートを提供します。

## セットアップフロー

1. uv init でプロジェクト作成
2. ツール群を設定追加 references にドキュメントを置いている。詳細は references/setup-guide.md を参照。

## クイックリファレンス

| コマンド | 用途 |
|---|---|
| 'uv run main.py' | 実行 |
| 'uv add' | パッケージ追加 |
| 'ruff check .' | リント |

Skills が生む 4 つの実用的な変化

Skills を導入することで、エージェント運用に4つの定性的な変化が現れます。これらは MCP や RAG だけでは届かなかった「型と暗黙知の継承」を可能にする点が共通項です。

※1 Few-shot prompting の延長線にある概念。Skills は構造化された many-shot の運用形態とみなせる

エージェントハーネスとしての Skills

エージェントハーネスとは、AIをエージェントとして稼働させる仕組みの総体です。例えば Claude Opus 4.6 は素のLLMですが、これを Claude Code というハーネスに乗せることでエージェントとして振る舞う。Skills はそのハーネスの中で「文脈の塊」を担当します。

発展トピック

Skills を本格運用すると「数の爆発」「依存関係」「品質劣化」という3つの管理問題に直面する。それぞれにアプローチが提案され始めている。