
AIエージェントの「agent」と「skill」って何が違うの?1ヶ月使い込んでわかったこと
Claude Codeを本格的に使い始めて1ヶ月。
ようやく「あ、これか」と腑に落ちた概念があります。
agentとskillの違いです。
「AIエージェントを作った」という話をよく聞くけど、実際に何をしているのか、常に目に見えているわけではないから実感がわかない人は多いと思います。僕もそうでした。
結論から。 agent.mdとskills.mdは「社員」と「マニュアル」の関係です。
skills.md = 会社のマニュアル・手順書
sns-guide.md ← SNS投稿のルール
design-principles.md ← デザインガイドライン
pitch-manual.md ← 投資家向けピッチの原則
誰が読んでも同じように動けることも目的にしています。 人に依存しない、会社の知識資産。文脈を持たない。
agent.md = 社員のジョブディスクリプション(JD)
例えば、僕の仕事でいうと...
kiminoorphee-director.md ─────────────────────────
役割: "キミノオルフェ"アカウント専任ディレクター
トーン: 詩的・余韻・音楽の純度を保つ
参照skill: sns-guide.md / brand-voice.md
禁止事項: ボーカルコーチングの宣伝はしない
どの役割を担って、どのマニュアルを・いつ・どんな判断軸で使うかを定義したもの。同じマニュアルを読んでも「自分の役割」に基づいて解釈が変わります。
「skillsだけで良くない?」という疑問
実はskillsだけでもタスクできます。 でもagentの有無でこうなるイメージ。
skillsだけの場合:
「SNS投稿を作って」と指示する → AIが全部のskillsを読む → どのルールが関係あるか自分で判断 → 毎回トーンや文脈がブレる
agents + skillsの場合:
「キミノオルフェの投稿を作って」と指示する → キミノオルフェディレクターが起動 → 該当するskillsだけを読む → 毎回同じトーン・判断軸で動く
つまり、agentを定義することで再現性が生まれるんです。 僕にとってはこれこそがagentを雇う(作る)本質でした。
面白い発見
じゃあ、agentとskillと作るにはどうしたら良いのか? 最初、僕は「agentとskillの違いはMarkdownの書き方に違いがあるんじゃないか?」と思ってました。
でも実はそれは違ったようです。
選別の決め手はファイルの「置き場所」。
.claude/agents/ にあるファイル
→ AIは「起動すべき人格 = agent」として扱う
.claude/skills/ にあるファイル
→ AIは「参照すべき知識 = skill」として扱う
中身のMarkdown形式はほとんど同じ。
置く場所がAIへの意味付けを決めているのです。
育てる順番が大事
よく、AIエージェントは使い込んで育てると言いますが、これもすこし漠然としているように感じたので自分なりの整理をしてみます。
① まずskillsから作る (知識の言語化)
② 次にagentを作る (役割の定義)
③ 最後にCLAUDE.mdを育てる (自動ルーティング)
逆にagentから作るとマニュアルを持たない新入社員ができるイメージです。 いくら能力が優秀でも、最初の一歩はマニュアルがないと力を発揮できないませんよね。
CLAUDE.md という司令塔
先ほどの③、突然聞き慣れないCLAUDE.mdというファイルが登場しました。
実は、agentとskillsの上位に、もう一つ重要なファイルがあるのです。それがこのCLAUDE.mdeです。
CLAUDE.mdは「組織図」であり「指揮官」と思ってもらえたら良いかと思います。
例えば...
Claude Codeに"キミノオルフェのSNS投稿を作って"と指示する
→CLAUDE.mdが「キミノオルフェ」というキーワードを検知
→ キミノオルフェディレクター(agent.)を起動させる
→ 該当skills (sns-guide.md / brand-voice.md) を参照させる
→ 実行
これが機能すると、僕がやることは先ほどのお題=指示を投げるだけになります。agent選択とskills参照はCLAUDE.mdが自動でやってくれる。
一番大事なこと
skillsは会社の資産で、agentは会社の人材です。
現実世界でも、仮に優秀な社員が辞めてしまっても、それまでの集合知はマニュアル化しておけば残りますよね?逆にマニュアルがなければ、どんなに優秀な新入社員もDAY1から力を発揮できない。
そして、より重要なのは、skills.mdはMarkdownで書かれた人間が読めるテキストファイルだから、Claude CodeだけじゃなくCursorでもGeminiでも、どのAIツールにも渡せるんです。
skillsを育てることは、ツールに依存しない知識資産を作ること。
今の僕のリアル
僕は今、ノンターミナスという自分の会社 (エンタメ開発・戦略コンサル・M&Aアドバイザリー)の会社と、今立ち上げ中のスタートアップで、合計43のagentを、14個のskillで動かしています。
Artist & Music / SNS Content / M&A Advisory / AI Development / Fundraising...
まだまだ完成形じゃない。
日々agent & skillを増やしたり統合したり、試行錯誤です。 でも使えば使うほど精度が上がっていく感覚があります。
そして30年近くの社会人経験から言えること
——組織設計の本質は、AIの時代になっても変わらない。
誰が・何を・どんな判断軸で動くか。それを言語化して共有できた組織が強い。
ツールがAIに変わっただけで、やっていることは実は同じなのかなと思っています。