これは何の話？
Claude Codeを日常的に使う開発者向けの実践ガイドです。セッションを始めるたびに「このプロジェクトではpython-pptxを使ってスライドを作って」「SQLはこのフォーマットで」といった説明を繰り返していませんか。CLAUDE.mdに書いても毎回読み込まれるとは限らず、commandsは手動で呼び出す必要があります。Agent Skillsは、必要なときに必要な知識だけを自動で読み込む仕組みです。
何がわかったか
Agent Skillsは指示、スクリプト、リソースをまとめたフォルダです。Claudeがタスクに応じて自動的に読み込み、その専門知識を活用します。Anthropicの公式ブログでは「新入社員向けのオンボーディングガイドを作るようなもの」と説明されています。CLAUDE.mdがグローバルな設定、commandsがショートカット、Hooksが自動化、Subagentsが専門家の呼び出しであるのに対し、Skillsは「Claudeができること自体を拡張する」点が異なります。
他とどう違うのか
LLMはステートレスでセッション間で記憶を保持しません。トークン制約もあるため、すべての知識を常に持たせることはできません。Agent Skillsは「必要なときだけ読み込む」アプローチにより、コンテキストを節約しながらも「状態を持っているかのように」振る舞えます。また、Rulesは特定のパスに対するルールですが、Skillsは専門知識そのものを提供します。
なぜこれが重要か
繰り返しの説明にかかる時間を節約できるだけでなく、出力品質の安定化にもつながります。一度Skillを作っておけば、関連するタスクで自動的にその知識が使われるため、チームで同じ品質基準を維持しやすくなります。特に大規模プロジェクトや複数人での開発において効果を発揮します。
未来の展開・戦略性
AnthropicはAgent Skillsをエージェント型AIの標準的な拡張手段として位置づけています。今後、Skillsのマーケットプレイスや共有機能が登場すれば、コミュニティで作成されたSkillsを活用できるようになるかもしれません。また、他のAIコーディングツールでも同様の仕組みが導入される可能性があります。
どう考え、どう動くか
たとえば、プロジェクトで頻繁に使うライブラリやフレームワークの使い方をSkillとして定義しておくと効率的です。
- まずはビルトインSkillsを確認し、何が利用可能か把握する
- プロジェクト固有のコーディング規約をカスタムSkillとして作成する
- CLAUDE.mdとSkillsの使い分けを明確にする
次の一歩：
- 今日やること：.claude/skills/ディレクトリを作成し、1つ目のカスタムSkillを書く
- 今週やること：Skillsを3回以上使い、動作を確認して改善する
限界と未確定
- Skillsが自動的に呼び出されるタイミングは環境や指示の書き方に依存します。必ず呼び出される保証はありません。
- 複数のSkillが競合する場合の優先順位は明確に定義されていません。試行錯誤が必要です。
- デバッグが難しいという声もあります。Skillの内容を簡潔に保つことが推奨されます。
出典と日付
じゃあ、おうちで学べる（公開日：2025-12-19）：https://syu-m-5151.hatenablog.com/entry/2025/12/19/173309
補足メモ
Claude CodeのAgent Skills設定ガイド──セッションを超えて専門知識を保持する仕組みは、単発のニュースとして消費するだけでなく、前提条件と適用範囲を明確にしながら読むことで実務に転用しやすくなります。Claude CodeのAgent Skills機能について、CLAUDE.mdやcommands、Hooksとの違いを整理しながら解説します。必要なときだけ専門知識を読み込む仕組みで、セッション間の「繰り返し説明」問題を解決できます。という観点を中心に、何が確定情報で何が解釈なのかを切り分けて整理することが重要です。
実際の運用では、関係者が同じ判断基準を持てるように、対象業務・期待効果・制約条件を短く言語化しておくと再現性が高まります。必要に応じて一次情報（https://syu-m-5151.hatenablog.com/entry/2025/12/19/173309）へ戻り、数値と日付の一致確認を定期的に行うと、認識ずれの拡大を防げます。
