「スキルを足したら、前からあったものが呼ばれなくなった」。Agent Skillsを運用していると、どこかでこの段階に来ます。
作るときは1本ずつ考えます。ところが並べた瞬間から、スキルは互いに干渉します。似た名前が競り合い、広く書いた説明文が関係ない依頼まで拾い、1本に詰め込んだ役割はどこから直せばよいのか分からなくなります。
この記事は、その困りごとを3つの型に分けて見分ける方法と、責務の境界をどこで切るかの判断基準を扱います。素材は公式ドキュメントと、運営元WEBMARKSが.agents/skills配下で動かしているスキル群の実例です。
こんなふうに調べていませんか
- スキルを足すたびに、前からあるスキルが呼ばれにくくなっていく
- 似た役割のスキルが2本ある。統合すべきか、そのままでよいのか決められない
- descriptionをどこまで広く書いてよいのか、手元に基準が無い
この記事を読み終えたときに手に入るもの
- 3つのアンチパターンを、症状のサインから見分けられるようになります
- 統合するか並存させるかを、対象の重なりで決められるようになります
- スキルを1本足すたびに、同じ4つの問いを当て直せるようになります
結論30秒でわかる、この記事の結論
- アンチパターンは、責務の境界を決めないままスキルを増やしたときに出る症状です。詰め込み型・競合型・起動語過大型の3つに分かれます。
- 見分ける手がかりは、核の処理・検査する対象・言い切れる職掌の3つです。
- 境界は一度切って終わりではなく、スキルが増えるたびに同じ問いを当て直します。
01AIエージェントのスキル設計で、Agent Skillsのアンチパターンはどこから始まるんですか？
若葉さんアンチパターンって、書き方が下手だとか、そういう話ですか？
鈴木さん書き方より前の話だと思っています。仕切りを決めないまま家具を運び込むのに近くて、1つずつは正しくても、置き終わると誰も通れなくなります。
Agent Skillsの設計におけるアンチパターンとは、責務の境界を決めないままスキルを増やし、発火の判定や保守が壊れる状態です。
運営元WEBMARKSは.agents/skills配下で59本のスキルを運用しています（2026-07-28時点、自社実例の実測台帳）。増えていく過程で実際に困ったことを型に分けると、3つに集約されました。
| 型 | 何が起きるか | 典型のサイン |
|---|---|---|
| ①詰め込み型 | 1つのスキルが複数の無関係な目的を抱え、descriptionが薄く広くなる | 「〜と〜と〜を行う」という並列の動詞が3つ以上続く |
| ②競合型 | 似た役割の複数スキルが、同じ依頼文で同時に候補へ挙がる | 除外文がないまま、近接ドメインのスキルが並んでいる |
| ③起動語過大型 | descriptionのトリガー条件が広すぎて、関係ない依頼にも反応する | 対象を言わずに「〜に関することは全部」と書いている |
3つは別々に起きるとは限りません。詰め込み型を避けようとして細かく割ると、今度は競合型が生まれます。境界の切り方を先に決めておくと、この行ったり来たりが減ります。
見分ける手がかりは、型ごとに違います。
- 詰め込み型は、分岐した先が同じ核の処理を通るかで見分けます。
- 競合型は、検査・処理の対象が同じか違うかで見分けます。
- 起動語過大型は、広さの内側にある責任を一言の職掌に言い切れるかで見分けます。
スキルそのものをどう作るかはAIエージェントのスキル設計｜呼ばれる単位に分ける4つの型で扱いました。ここではその先、境界の切り方だけに絞ります。
この章のまとめ
3つの型は、核の処理・対象・職掌という別々の手がかりで見分けます。
02AIエージェント用のスキル1本に役割を詰め込むと、Agent Skillsは何が壊れるんですか？
Agent Skillsは「複数のスキルを組み合わせて複雑な作業をこなす」という設計思想を掲げています（出典: Agent Skills公式）。1本に全部の役割を集めるのは、この組み合わせ前提と逆を向いた作りです。
技術的な条件も、詰め込みを不利にします。descriptionは1スキルにつき1個、最大1,024字で、起動判定の材料はこの一文だけです（出典: Agent Skills公式仕様）。無関係な目的をいくつも収めようとすると、次のような書き方になりがちです。
# 詰め込み型になりやすい書き方（例）
description: 記事を書き、画像を生成し、SNSに投稿し、効果を計測する。発火を判定する側から見ると、この一文はどの依頼にも半分だけ当てはまります。半分だけ当てはまる説明文は、呼ぶ理由にも、見送る理由にもなりません。
核の処理が1つに定まっている説明文は、動詞が1本の流れでつながります。自社のseo-articleは、メインKW1個の入力から本文執筆・図解・品質ゲートまでを一気通貫で行うと定義されています。入力から出力までが1本の変換でつながっています（2026-08-02時点）。
説明文そのものの書き方は、Claude Codeのスキルが発火しない｜descriptionを直す4層で扱った要素と同じです。
この章のまとめ
詰め込み型のサインは動詞の数です。並んでいるか、つながっているかを見ます。
03詰め込み型のアンチパターンに見えるAIエージェントのスキルは、どこまでなら1本のままでいいんですか？
高梨課長うちのスキルにも、モードが4つあるものがあります。これは割ったほうがいいんでしょうか。
鈴木さんモードの数では決めていません。入口が分かれたあと、途中で同じ道を通るかどうかを見ます。合流するなら1本のままにしています。
詰め込みに見えても、アンチパターンとは限りません。
harukaze-ad-creative-flowはバナー広告とLPという異なる2種類の成果物を扱います。descriptionの時点で、固定の2択メニューから入って選んだ側だけを実行すると役割を分けています（2026-08-02時点）。
meeting-followupも会議・商談・CA面談・採用面接の4モードを持ちます。ただし、録音を構造化議事録に変換する核の処理は共通です。商談モードだけが持つメール下書きとCRM登録は、モードが確定した後にだけ動く追加ステップにすぎません。
判断基準は、分岐した先が同じ入力から同じ核の処理を通り、出力テンプレートだけが違う形になっているかどうかです。核の処理まで分かれるなら、それは1つのスキルの中に複数のスキルが同居しています。
図にすると、モードの多さは判断材料になっていないことが分かります。見るのは枝の本数ではなく、枝が途中で合流するかどうかです。合流点があるスキルは、モードがいくつあっても手を入れる場所が1か所に残ります。
この章のまとめ
分けるかどうかは、モードの数ではなく合流点の有無で決めます。
04似た役割のAIエージェントのスキルが並ぶと、アンチパターンとして発火はどう割れるんですか？
WEBMARKSには「監査」を名乗るスキルが5本あります。vault-audit・safety-audit・hierarchy-audit・automation-health・devils-advocateです。同じ動詞（監査する・点検する）を使う以上、放置すれば衝突候補になります。
自社59本の説明文を監査した結果があります（出典: Agent Skillsの発火精度｜59本の監査で見えた検証の組み立て方）。一覧にdescriptionが表示される35本のうち、除外文（「これには発火しない」の明記）を持つのは9本でした。近接ドメインに複数スキルが並ぶ場所ほど、この除外文が集中しています。
名前が近いというだけでは、まだ何も決まりません。判定は次の章で、対象を並べてから行います。
この章のまとめ
名前が近いスキルは衝突候補になりますが、候補であることと競合型であることは別です。
05監査を名乗るAIエージェントのスキル5本は、アンチパターンとして統合しなくていいんですか？
この5本は、統合すべき競合型でしょうか。対象を並べると、検査する先が5本とも違います。
| スキル | 検査する対象 | 起動の主体 |
|---|---|---|
| vault-audit | Vault全体の構造・リンク・命名の機械監査 | 定期実行・依頼時 |
| safety-audit | セキュリティ・バックアップの健全性 | 週次定期実行 |
| hierarchy-audit | ルール・スキルへの到達可能性 | 依頼時・大規模変更後 |
| automation-health | 自動化が実際に動いたかの実測証拠 | 依頼時・週次点検 |
| devils-advocate | 成果物の「甘さ」そのもの | 提示直前に必須 |
対象が5つとも違うため、これは競合型ではありません。ただし除外文の書き方には偏りがあります。
2026-08-02時点で説明文を読み比べると、vault-auditとdevils-advocateの2本だけが、残り4本の対象を名指しして自分の説明文に書いています。hierarchy-audit・safety-audit・automation-healthの3本は名指しされる側で、自分自身の説明文には他4本への言及がありません。
置き直してみると、表では横一列に見えた5本が、同じ区画には収まりません。名前が似ていることと、仕事が重なっていることは別だからです。名前で疑い、対象で判定する。この順番を逆にすると、重なっていないものまで統合してしまいます。
この章のまとめ
競合かどうかは名前の近さではなく、検査する対象が重なっているかで決めます。
06対象が同じAI社員のスキル設計では、Agent Skillsのアンチパターンはどう表に出るんですか？
競合型になるのは、対象が同じで切り口だけが違うときです。
diagram-makerとhtml-diagram-explainerは、ともにフォルダ構成や仕組みを1枚のHTML図解にする対象を持ちます。2026-08-02時点で両者の説明文を確認すると、除外文は片側にしかありません。
html-diagram-explainer側には「HTMLやメディアの指定がない一般的な図解依頼には発火しない（代わりにdiagram-makerを使う）」という名指しの一文があります。diagram-maker側には、対応する記述がありません。
重なりを描くと、除外文が守っているのは片側だけだと分かります。名指しした側は正しく降りますが、名指しされていない側が先に候補へ挙がったときには効きません。
対象が同じ場合の直し方は2つです。除外文を両側に置くか、対象そのものの違いを一言で言い切るかです。後者のほうが、3本目が増えたときにも効きます。
この章のまとめ
片側だけの除外文は、降りる側にしか効きません。重なっているなら両側に書くか、違いを言い切ります。
07起動語を広げすぎたAI導入のスキルは、アンチパターンとどう見分けるんですか？
若葉さん広く書いてあるほうが、いろいろな依頼で呼んでもらえそうな気がします。
鈴木さん呼ばれる回数は増えるかもしれません。ただ、呼ばれてよかった回数は増えないんです。広いかどうかより、その広さに名前が付いているかを見ています。
Agent Skills公式ベストプラクティスは、descriptionの悪い例としてHelps with documents（対象が不明）を挙げています。良い例は、PDFを扱う場面やPDF・フォーム・文書抽出への言及を、対象条件として具体的に書く形です（出典: Agent Skills公式ベストプラクティス）。
広さそのものが禁じられているわけではありません。自社のweb-productionは、20以上の言い回しをdescriptionに列挙しています。「サイトを作りたい」「LP」「SEO」「公開したい」「WordPress化」などです（2026-08-02時点）。Web制作に少しでも関する発言なら、明示依頼がなくても必ず使うと書かれています。
範囲だけを見れば起動語過大型に見えます。ただしこれは、ヒアリングから公開・納品までを1本で一貫させるという、単一の責任範囲に対応した広さです。
書き換えの前後を並べると、長さはさほど変わらないことが分かります。変わっているのは字数ではなく、広さに名前が付いているかどうかです。
起動語過大型のアンチパターンになるのは、広さの内側にある責任が1つに集約できないときです。「資料を処理します」も「Web制作に関することは全部」も、字面だけ見れば似た広さです。前者は対象を言っていない空虚な広さで、後者は入口から出口までという1つの責任を言い切った広さです。
見分け方は、その広さを一言の職掌に置き換えられるかどうかです。置き換えられないなら、広さの内側に無関係な責任が同居しています。
この章のまとめ
広さは字数では測れません。一言の職掌に言い換えられるかで測ります。
08AIエージェントのスキル設計で、Agent Skillsのアンチパターンを断つ境界はどこで切るんですか？
3つの型を見分けたら、次は境界をどこで切るかです。自社の実例と公式の設計思想から、4つの問いへ順番に答える形へ整理しました。
| 問い | どちらに転ぶか | 次の一手 |
|---|---|---|
| ①分岐は同じ核の処理を通るか | 通るなら1本のままでよい | モード分けで表現する。通らないなら詰め込み型を疑って分割する |
| ②検査・処理の対象は同じか | 同じなら重なっている | 統合か片方への集約を検討する。違うなら別スキルのまま除外文で棲み分ける |
| ③広さを職掌1つに言えるか | 言えるなら広いままでよい | 言えないなら起動語過大型を疑い、対象を具体化する |
| ④「ここ以外に行きたくない語」があるか | あるならそれが軸になる | descriptionの中心に置く。無いなら別スキルの職掌である可能性を疑う |
①と②は逆向きに見えますが、見ている段階が違います。①は1本のスキルの内部で分岐が起きているかを見ます。②は複数のスキルが並んだあとに、対象そのものが重なっていないかを見ます。
この章のまとめ
境界を切る前に、いま自分が内側と外側のどちらを見ているかを確かめます。
09アンチパターンの4つの判断基準を実際のAIエージェントのスキルに当てると、答えはどう分かれるんですか？
先に出した2つの組へ、この4問を当ててみます。
diagram-makerとhtml-diagram-explainerの組は、②で対象が同じという答えになります。④では「HTML図解」という語を、html-diagram-explainer側がより強く言い切っています。次の一手は、diagram-maker側の説明文に「1ファイルHTML図解に特化した用途はhtml-diagram-explainerを使う」という一文を足すことです。
監査系の5本は、②で対象が違うという答えになります。そのまま並存させます。残る検討事項は、除外文を書いていない3本に、他4本への言及を足すかどうかです。
同じ4問を当てているのに、行き先は反対になります。答えの善し悪しが違うのではなく、対象の重なり方が違うからです。判断基準は結論を出す道具ではなく、どちらの結論へ進むかを分ける道具です。
この章のまとめ
4問は答えを固定しません。同じ問いから、統合と並存の両方が出ます。
10境界を切ったあとも、AI社員のスキルにアンチパターンが戻ってくるのはなぜですか？
高梨課長一度整理すれば、しばらくは持つものでしょうか。
鈴木さん持たないと思っています。スキルが1本増えるたびに、隣との関係が変わるので。整理そのものより、整理し直す前提を持っているかどうかが効きます。
戻ってくる道は3つあります。
分割しすぎて、参照を追えなくなる。 詰め込み型を恐れて1つの処理を細かく割ると、スキル間の呼び出し関係を人が覚える必要が出ます。SKILL.md本体を500行以内に収める目安はありますが（出典: Claude Code公式ドキュメント）、これは1スキルの中の話で、分割数そのものの上限ではありません。
除外文を書いて満足し、対象の違いを言葉にしない。 除外文は対症療法です。対象そのものが同じ2本に除外文だけを足すと、descriptionが長くなるだけで、3本目が増えたときにまた同じ調整が要ります。対象の違いを一言で言えるかを先に確かめたほうが、あとから増える近接スキルにも効きます。
棚卸しをしないまま、境界の判断を1回で終わらせる。 境界は一度切ったら終わりではありません。WEBMARKSは59本のスキルを運用する中で、命名や分割の型を運用しながら固めてきました。新しいスキルが増えるたびに、4つの問いを当て直す前提を持ちます。
この章のまとめ
境界は一度きりの成果物ではなく、更新し続ける前提の設計です。
11生成AIのスキルを増やす前に、アンチパターンをどこで止めるんですか？
スキルを1本足す前に、次の項目を上から確認します。
- このスキルの分岐は、同じ核の処理を通ったうえでの枝分かれか
- 分岐ごとに使うツール・書き込む相手・承認の要不要が変わっていないか
- 近い名前・近いドメインのスキルが他に存在しないか洗い出したか
- 存在する場合、検査・処理の対象が同じか違うかを確認したか
- 対象が同じ場合、統合または片方への集約を検討したか
- 対象が違う場合、除外文で代わりのスキル名を明記したか
- descriptionの広さを、一言の職掌に言い換えられるか確認したか
- 「このスキル以外に行きたくない」と言える語をdescriptionの中心に置いたか
- 分割した場合、呼び出し関係を追う手間が分割の効果を上回っていないか
- 新しいスキルを足すたびに、この4つの問いを再適用する運用にしたか
この確認を作ったあとに回すと、直す対象がすでに動いているぶん、手戻りが大きくなります。順番を先へ寄せるだけで、同じ項目でも効き方が変わります。
この章のまとめ
確認は作った後ではなく、足す前に通します。
12よくある質問
スキルがアンチパターンに陥っているか、いちばん簡単に確かめる方法は何ですか
descriptionを声に出して読み、結局このスキルは何をするのかを一言で言えるか確かめます。言えなければ、詰め込み型か起動語過大型のどちらかを疑います。言えたのに隣のスキルと同じ一言になるなら、今度は競合型を疑います。手元で数分あればできる確認なので、新しいスキルを足すたびに通す価値があります。
起動語が広すぎるアンチパターンかどうかは、字数で判断できますか
できません。字数ではなく、その広さが1つの職掌に言い換えられるかで判断します。web-productionのように広くても、職掌が1つなら問題にはなりません。逆に短く書いてあっても、対象を言っていない説明文は空虚な広さのままです。長さと広さは別の性質だと考えてください。
似た役割のスキルは、見つけ次第すぐ統合すべきですか
いいえ。検査・処理の対象が違うなら、統合せずに除外文で棲み分けます。監査を名乗る5本は、対象が5つとも異なるため統合していません。名前が似ているという理由だけで寄せると、それぞれが受け持っていた依頼のどれかが行き場を失います。まず対象を並べて、重なっているかどうかを見てください。
詰め込み型と起動語過大型、2つのアンチパターンは何が違うのですか
詰め込み型は、1本のスキルの内部で核の処理が複数に分かれている状態です。起動語過大型は、内部の処理は1つでも、descriptionの対象範囲が職掌に言い切れないほど広い状態です。前者は中を割って直し、後者は外側の言い方を絞って直します。症状が似ていても、手を入れる場所が違います。
3つのアンチパターンの型は、同時に起きますか
起きます。詰め込み型を避けようとして分割しすぎ、結果として競合型を生む連鎖はよく見られます。だから3つを別々の課題として順に潰すより、境界の切り方をひとまとまりで決めるほうが早く収まります。4つの問いを順番どおりに通すのは、この連鎖を止めるためです。
個人で使う範囲でも、この判断基準は必要ですか
必要だと考えています。スキルが数本の段階では影響が小さくても、増えるたびに4つの問いを当て直す習慣があると、あとの棚卸しが軽くなります。人数の問題ではなく、並べたスキルの数の問題です。
13まとめ｜今日やる3つのこと
見分ける手がかりは、核の処理・対象・職掌の3つでした。統合するか並存させるかは、名前の近さではなく対象の重なりで決めます。そして境界は、スキルが増えるたびに引き直します。
今日はこの順で手をつけます
手元のスキルを1本選び、説明文を声に出して読む
一言で言えるかどうかが、最初のふるいになります
名前が近いスキルを並べて、検査する対象が重なっているかを書き出す
重なっていなければ、統合の検討そのものが不要です
重なっていた組に、降りる一文を両側へ足す
片側だけでは、先に候補へ挙がったほうに効きません
AI検索では、こう聞かれています
AIエージェントのスキルが増えすぎたとき、どこで切ればいいんですか？
「AIエージェントのスキル設計で、Agent Skillsのアンチパターンを断つ境界はどこで切るんですか？」の章で4つの問いに整理しています
似た役割のスキルは、統合したほうがいいんですか？
「似た役割のAIエージェントのスキルが並ぶと、アンチパターンとして発火はどう割れるんですか？」の章で判定のしかたを扱っています
descriptionの起動語が広すぎるかどうかは、どう判断するんですか？
「起動語を広げすぎたAI導入のスキルは、アンチパターンとどう見分けるんですか？」の章で見分け方を示しています
分割しすぎると、今度は何が起きるんですか？
「境界を切ったあとも、AI社員のスキルにアンチパターンが戻ってくるのはなぜですか？」の章に戻り道をまとめています
次に読むなら、この記事です
