リモート開発メインのソフトウェア開発企業のエンジニアブログです

Claude のスキルは単なるテキストファイルで特別な仕組みはない

最近、本ブログでも Qiita や Zenn でも AI 絡みの話題ばかりで食傷気味の人もいるかと思います。そんな方は申し訳ないのですが、そっとタブを閉じてもらえれば思います。

今回は Claude のスキル機能についてちょっと書こうと思います。

スキルとは

エンジニアの方であれば知っている方が大半かとは思いますが、スキルとは、AI エージェントにやらせる定型的な処理を SKILL.md というファイルに記載することで、その処理を簡単に呼び出すことができる仕組みです。プログラムで言えばサブルーチン、関数、のようなものです。

なお、タイトルに「Claude のスキル」と書きましたが、正確には Agent Skills という名前で仕様が決まっており、Claude だけではなく、最近は ChatGPT や Gemini でも使えます。

Overview – Agent Skills

Moba Pro

どのように作るか

スキルの実体は SKILL.md というファイル(+必要に応じて設定ファイルやスクリプト)です。テキストエディタを使って自分で書く事も出来ますが、Claude Code や Codex CLI の skill-creator みたいな仕組みを使った方が圧倒的に楽なので、そちらをお勧めします。

自分で作らずに、スキルを集めたサイトなどもありますので、興味のある方は覗いてみてください。

スキルの実行の仕組み

基本的には単なるシステムプロンプト

作成したスキルは、Claude や Claude Code、ChatGPT などから呼び出す事が出来ます。

と書くと、作成したスキルを実行するための特別な仕組み・モジュールなどが Claude や ChatGPT などのツールやサーバーに含まれていると思ってしまいますが、実際には SKILL.md の内容をシステムプロンプトとして Anthropic API なり OpenAI に送っているだけです。

例えば、Dify は Agent Skills をサポートしていませんが、Dify の Agent node に Claude Code で作成した SKILL.md を システムプロンプトとして読み込ませて実行し、同じような結果を出すことも簡単にできました。

スキルから実行できるもの

SKILL.md の中には色々と処理が書いてあるのですが、その AI エージェントが実行可能な処理しか実行できません。例えば Claude Code の場合は、大雑把に言うと以下のような事が実行できます。

  • MCP サーバー
  • ローカルにインストールされているコマンド
  • ウェブ検索、ローカルファイルの読み込み・修正等の最初から利用できるツール

Agent Skills を直接サポートしていない Dify などのツールで SKILL.md を実行するためには、SKILL.md の中にそのツールから実行できる処理のみ記載されている、という条件になります。Dify であれば Agent ノードで MCP サーバーやウェブ検索などがサポートされていますので、それらは使ったスキルは実行可能です。一方、scripts/ に配置された Python ファイルを実行するようなスキルを実行するのは難しいです。

まとめ

Claude のスキル機能は、今では Agent Skills として標準化され、ChatGPT などのツールでもサポートされています。普通にスキルを使っているだけだとそうしたツールに特殊な仕組みがあるように思ってしまいますが、スキルの実体は SKILL.md というファイルが必須の要素で、スキルによっては scripts/ 等の任意のファイルが含まれているだけというシンプルなものです。

構造が理解出来れば、Agent Skills が直接サポートされていない Dify などのツールでも Claude Code 等で作成したスキルを(条件付きですが)実行する事が出来ます。

本題ではありませんが、スキルは開発に限らず様々な業務で使える非常に便利な機能なので、あまり使った事がない人は是非使ってみてください。

← 前の投稿

Claude Code の Discord プラグインを使ってみた

次の投稿 →

コメントを残す