🍽️

2026年初頭のClaude Code Skillsについてまとめる

に公開

はじめに

Claude Codeの進化が凄まじいです。
2026年1月7日にv2.1.0がリリースされたかと思えば、1月31日には23件目のv2.1.31がリリースされています。
日数で言うと31日中17日リリースがあったようです。(とてもではないが追いきれない...🥲)

その中でも一際目を引いたのがやはりv2.1.3のcommandsとskillsの統合でしょうか。Xを見ているとこれを機にcommandsからskillsへの移行がかなり加速したように見えます。

と言うわけでこの記事では、skillsが登場から他のどんな機能を食って今日まで来たのかをまとめてみようと思います。

0. 前提

Claude Codeの主な4つの拡張方法

Claude Codeには、AIの振る舞いをカスタマイズするための4つの主要な仕組み(Hooksは除く)があります。

機能 配置場所 概要
Rules .claude/rules/ プロジェクト全体のルール
Commands .claude/commands/ 手動で実行するワークフロー
Skills .claude/skills/ 自動/手動両対応の専門知識
Subagents .claude/agents/ 独立したタスク実行

skillsのフロントマター

Claude Codeではcommandsやskillsの定義ファイルのヘッダ部分にフロントマターと呼ばれるメタデータを記述することで、動作をカスタマイズすることができます。
詳しくはリンク先をご参照ください。

https://code.claude.com/docs/en/skills#frontmatter-reference


1. Skillsの登場

2025年10月16日、AnthropicはClaude Skillsをリリースしました。

Skillsの持っていた主な特徴は以下の通りでした。

  • Composable: スキルを組み合わせて複雑なタスクを実行できる
  • Portable: スキルをClaude.ai / Claude Code / APIの3プラットフォームで共通フォーマットとして利用可能("Create once, use everywhere")
  • Efficient: フロントマターのdescriptionに基づいて、必要な時だけスキルをロード
  • Powerful: スキルには実行可能コードを含められる

当時の課題感

当時の課題感は以下の公式ブログに記載されている通り、専門的なエージェントを作成するコストの高さ、拡張性の乏しさがあったように思えます。

https://claude.com/blog/equipping-agents-for-the-real-world-with-agent-skills

As model capabilities improve, we can now build general-purpose agents that interact with full-fledged computing environments, but as these agents become more powerful, we need more composable, scalable, and portable ways to equip them with domain-specific expertise.

エージェントが複数ドメインに渡る複雑なタスクを実行できるようになってきたことにより、composable(組み合わせ可能)で、scalable(拡張可能)で、portable(ポータブル)な方法でドメイン固有の専門知識を与える必要が出てきました。

Instead of building fragmented, custom-designed agents for each use case, anyone can now specialize their agents with composable capabilities by capturing and sharing their procedural knowledge.

ユースケースごとに断片化されたカスタム設計のエージェントを構築する代わりに、誰でも手続き的な知識を記録・共有することで、組み合わせ可能な能力を用いてエージェントを専門化できるようになります。

また、他の記事を見てみるとMCPツールのコンテキスト圧迫を課題に感じる声もあり、skillsの持つProgressive disclosure(段階的開示)という特性を評価する声も多かったみたいですね。

https://azukiazusa.dev/blog/mcp-tool-context-overflow/#progressive-disclosure段階的開示

2. 登場時のRules, Commands, Skills, Subagentsの棲み分け

2025年10月のskills登場時、skillsにはさほど多くの機能が追加されていなかったため4つの機能には明確な役割分担があったように思えます。

登場時の比較表

機能 呼び出し コンテキスト 主な用途
Rules セッション開始時に常時適用 メイン 不変のルールを読み込み
Commands 手動呼び出し時のみ メイン 再利用可能なワークフローを提供
Skills descriptionに基づいて自動呼び出し メイン 専門知識を提供
Subagents descriptionに基づいて自動呼び出し 独立 特定種類のタスクに特化

https://code.claude.com/docs/en/skills

https://www.builder.io/blog/agent-skills-rules-commands

3. アップデート履歴

次にskills登場後からskillsに関連する主要な(skillsの立場が変化するような)アップデートを見てみます。
細かいUXの改善系のアップデートは多数含まれているのですが、ここでは省略しています。

https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

v2.0.20: Skills登場

リリース✨

v2.0.43: subagentsのskillsフロントマターの追加

subagentsのフロントマターでskillsフィールドを指定できるようになりました。
これによりスタートアップ時にsubagentsに特定のskillsを読み込むことができるようになりました。

v2.1.0: context: fork、agentフィールド

このアップデートでskillsに多数の機能が追加されました。

skillsにcontext: forkフロントマターの追加

skillsのフロントマターで context: fork を指定することで、skillsをサブエージェントとして実行可能になりました。

skillsにagentフロントマターの追加

skillsのフロントマターで agent フィールドを指定できるようになりました。
これによりcontext: forkが指定されている際に特定のサブエージェントを指定してskillsを実行可能になりました。

v2.1.3: CommandsとSkillsが統合

commandsとskillsが統合されました。
これにより.claude/skills配下のskillsは/で呼び出せるようになりました。

4. 今のSkillsの立ち位置 - 他機能(rules, commands, subagents)との関係性

Rules と Skills

rulesとの関係性は発表当初から変わっていないように思えます。
相変わらず初期から読み込まれるrulesと必要なときに呼び出されるskillsという関係性は維持されています。
強いて言えば、subagentsにskillsフロントマターが追加されたことで「起動時に前提知識を与える」という点ではrulesの役割と一部重複していると言えるかもしれません。

Commands と Skills

v2.1.3の統合により、commandsはほとんどskillsの簡易版のようなものになりました。
ユーザーからの呼び出しに関する設定(user-invocable)とエージェントからの呼び出しに関する設定(disable-model-invocation)もフロントマターに存在します。
これは、/skillsを明示的に呼び出す設定とエージェントから暗黙的に利用する設定の利用可否をskillsに設定できることを意味します。
そうなると、従来commandsの振る舞いはuser-invocable: true(default)かつdisable-model-invocation: trueに設定することでskillsで表現できます。
skillsには指示を複数ファイルに分割可能であり、exampleやtemplateを個別ファイルに分けて拡張しやすいという利点がそもそも存在するため、個人的にはcommandsをあえて利用する理由も見つかりません。
実際、私はskillsにSKILL.mdのみを配置するスタイルに移行しました。

Subagents と Skills

context: forkオプションの追加により、やや境界は曖昧になっていますが、使い分けに関しては以下記事で詳しく考察、整理されています。

https://giginet.hateblo.jp/entry/2026/01/27/202636

giginetさんの記事では公式ドキュメントを引用しつつ、skillsの内容を「情報参照用(Reference Content)」と「タスク実行用(Task Content)」の2種類に分類したうえでどのケースでskillsを利用すべきか整理されています。詳しくは記事をご覧ください。
結論だけ引用させていただくと、

  • skillsには情報参照用のReference Contentとタスク実行用のTask Contentがある
  • Reference Contentとしてのskillsを利用する際はsubagentsを主とし、skillsフロントマターにReference Contentを展開して利用する
  • Task Contentとしてのskillsを利用する際はskillsを主とし、agentフロントマターでskills(Task Content)を実行するエージェントを選択して利用する

まとめ

ここまでskillsの登場から現在までのアップデートの流れを追い、現在の立ち位置を確認しました。
わかっていたことではありますが、skillsはClaude Codeを拡張する上ではほぼ必須の仕組みになっていると思いつつ、まだrulesとsubagentsとは責務が分かれている点が面白いですね。
今後もClaude Codeのアップデートを注視していきたいと思います。

参考資料

公式

参考記事

GitHubで編集を提案

Discussion