Agent Skillsを一番かんたんに作る方法(Claude Code + skill-creator)

に公開

対象読者

  • Agent Skills が気になっているけど、まだ触れていない方
  • 公式ドキュメントを読む前に、まず動かしてみたい方
  • 細かい仕組みより「とりあえず作れる」を優先したい方

はじめに

Claude Code には「Agent Skills」という機能があります。

Anthropic が開発した 「エージェントに新しい機能や専門知識を提供するためのフォーマット」 で、2025年12月にオープンスタンダードとしてリリースされ、Codex や Cursor など他の主要なAIツールでもサポートされはじめています。

Agent Skills は、Claude Code と skill-creator を使えば簡単に作ることができます。この記事では skill-creator のインストール方法と使い方を紹介します。

ちなみに skill-creator 自体もスキルで作られているので、「スキルでスキルを作る」というややこしい構造になっています。深く考えず、とりあえず手を動かしていきましょう。

skill-creator をインストールする

Claude Code に、Anthropic が提供する公式スキルセットをインストールします。

# マーケットプレイスを追加
/plugin marketplace add anthropics/skills

# スキルセットをインストール
/plugin install example-skills@anthropic-agent-skills

Claude Code を再起動したあと、/skills コマンドで skill-creator が表示されればインストール完了です。

skill-creator でスキルを作る

skill-creator を使えば、AIと対話しながらスキルを作ることができます。スキルを作成するときは /model opus コマンドで Opus モデルに切り替えておくと、手戻りや調整が少なく済むのでおすすめです。

方法1:新しくスキルを作る

スキルの概要を説明し、AskUserQuestionツールを使ってAIにヒアリングしてもらいながらスキルを作成します。

skill-creatorを使って、○○のスキルを作成して。
ユーザーに判断を求める場合はAskUserQuestionツールを使って質問して。

このように対話しながらスキルを作成することができます。

スキル作成

方法2:会話からスキル化

AIとやり取りして上手くいった会話履歴があれば、それをそのままスキル化することもできます。

(上手くいった会話の後に)
これまでの会話の流れをskill-creatorを使ってスキル化して

これで、自分のノウハウを再利用可能なスキルとして保存できます。

スキルの保存場所

作成したスキルは以下の場所に保存されます。

# プロジェクト専用(チームで共有可能)
.claude/skills/my-skill/

# 個人用(全プロジェクトで使用可能)
~/.claude/skills/my-skill/

作成されるスキルファイルは、以下のようなシンプルな構成です。スキルは Markdown ファイルなので、Git管理やチーム共有も簡単です。

.claude/skills/my-skill/SKILL.md
---
name: my-skill
description: スキルの説明
---
(ここにAIへの指示が記述されます)

スキルセットの無効化

スキルはAIツール起動時に全スキルの「name」と「description」を読み込むため、スキル未使用の場合でも1スキルあたり約100トークンほど消費します。少しでも消費を抑えたい方は、スキルを作成するとき以外は無効化しておくとよさそうです。

/plugin でプラグイン一覧を開き、Installedexample-skillsDisable plugin を選択します。

スキルセットの無効化

LLMには「コンテキストウィンドウ」という記憶領域の制約があります。トークン消費を抑えることで、応答品質の向上やコスト削減に繋がります。詳しくはこちらの記事をご覧ください。

https://zenn.dev/aun_phonogram/articles/44d298f8d9d0fd

おわりに

Agent Skills は、複数のAIツール間で共有できるオープンスタンダードとして設計されています。いま Claude Code で蓄積している資産は、近い将来、他のAIツールでもそのまま活用できるようになっていくと思います。

また、チームで繰り返し行う作業を「スキル」として定義しておけば、属人化を防ぎながらノウハウ共有できます。Git管理が可能なため、スキルのバージョン管理や継続的な改善も容易です。

「また同じ対話を繰り返している」と感じたら、ぜひスキル化に挑戦してみてください!

参考リンク

https://agentskills.io

https://developers.openai.com/codex/skills/

https://cursor.com/ja/docs/context/skills/

AUN Tech Blog

Discussion