SKILL.md ランブックがマーケティング Agents を再現可能にする理由
UnifAPI の Skill レイヤーへの実践ガイド: トリガーフレーズ、データ呼び出し、出力テンプレート、確信度のルール、そして公開データの境界。
要点: Skill は UnifAPI Agent の中の再現可能な単位です。いつそのワークフローを使うか、どんなデータを取得するか、出力をどう構造化するか、どこで止まるかをアシスタントに伝えます。
プロンプトは書くのは簡単で、維持するのは難しいものです。役立つマーケティングワークフローには、1 つの指示以上のものが必要です。トリガー、入力要件、データソースの選択、確信度のルール、出力テンプレート、そして制限が必要です。
だからこそ、UnifAPI Agents は Skills として実装されています。
Skill に含めるべきもの
| Skill のパート | 何をするか |
|---|---|
| 名前と説明 | アシスタントが正しいワークフローへ振り分ける助けになる |
| いつ使うか | トリガーフレーズとユーザーの意図を列挙する |
| 入力 | データを呼び出す前に集めるべき文脈をアシスタントに伝える |
| データ呼び出し | 使うべき UnifAPI の操作や Data Skills を名指しする |
| ワークフロー | 仕事をステップに変える |
| 出力テンプレート | 曖昧な要約を防ぐ |
| 確信度のルール | 観測された事実と推論された判断を切り分ける |
| 境界 | Agent を読み取り専用かつ正直に保つ |
Skill は 1 つの能力に名前を付けるとき最も強くなります。keyword-research は Skill です。seo-audit は Skill です。ai-answer-gap は Skill です。「マーケティングを全部やる」は Skill ではありません。
Enhanced、Advice、Data の Skills
UnifAPI は 3 種類の Skill を使います。
| Skill の種類 | 意味 | 例 |
|---|---|---|
| Enhanced | ライブの公開データを呼び出すマーケティング能力 | SEO 監査、KOL 料金算定、AI ビジビリティ監査 |
| Advice | ライブ呼び出しのないフレームワークや判断 | スキーマのガイダンス、ポジショニングのフレームワーク |
| Data | Platform Agent が所有する決定論的なソースガイド | LinkedIn Data Skill、Reddit Data Skill |
この区別が製品を明確に保ちます。役立つマーケティング Skill のすべてがライブ API 呼び出しを必要とするわけではありません。しかし、Skill が公開ビジビリティについて事実の主張をするなら、レコードを使うべきです。
なぜ Skills は操作を名指しすべきなのか
アシスタントは MCP を通じて操作を発見できますが、発見がワークフローのすべてではありません。良い Skill は、それでもアシスタントに、その仕事にとってどのデータファミリーが重要かを伝えるべきです。
たとえば、SEO 監査の Skill はこう言えます。
- ターゲットクエリのライブ SERP 根拠を取得する。
- 需要の文脈にはキーワード概要と履歴を使う。
- ターゲットページと上位競合ページには Browser Markdown を使う。
- 観測された根拠と推奨を切り分けた修正プランを返す。
これは「必要なら API を使う」よりもはるかに優れています。
出力テンプレートは製品の一部
出力の形は、多くのエージェントワークフローが失敗するところです。テンプレートがなければ、アシスタントは行動に移せない、心地よいだけの要約を返すかもしれません。
Skill は成果物を指定すべきです。
| ワークフロー | 役立つ成果物 |
|---|---|
| KOL 料金算定 | 低/基準/高のレンジと確信度付きの、ランク付けされたクリエイター表 |
| GEO 監査 | プロンプトごとの引用とメンションのマトリクス |
| ローカルパックスキャン | クエリ、順位、競合、レビュー数、マップ上の位置 |
| 競合プロファイリング | ローンチのタイムライン、チャネル、主張、根拠、リスク |
| コンテンツ戦略 | 需要、出典の根拠、適合性を備えた機会のバックログ |
テンプレートはアシスタントを機械的にするものではありません。回答をレビュー可能にするものです。
確信度のルールが偽りの確実性を防ぐ
公開データは強力ですが、全知ではありません。Skill はアシスタントに、次のようにラベル付けさせるべきです。
| ラベル | 意味 |
|---|---|
| 観測 | 公開レコードから直接読み取ったもの |
| 推論 | 複数のレコードから導き出したもの |
| 仮定 | ユーザーが提供したもの、または分析を完了するために必要なもの |
| 不明 | 公開データからは得られないもの |
それはマーケティングワークフローで重要です。KOL 料金算定の Skill は、最終見積もりではなくレンジを推定できます。GEO の Skill は、ビジビリティを報告できますが、将来の掲載を保証はできません。ローカル SEO の Skill は、リスティングを監査できますが、編集はできません。
短い Skill 品質チェックリスト
Skill を公開する前に、こう尋ねましょう。
- 1 つの具体的な仕事にマッピングされているか?
- 説明に実際のトリガーフレーズが含まれているか?
- 必須と任意の入力を指定しているか?
- 使うべきデータソースや Data Skills を名指ししているか?
- 出力テンプレートを含んでいるか?
- 確信度と境界を説明しているか?
- フォローアップ作業のために関連する Skills へリンクしているか?
答えがノーなら、その Skill はおそらくワークフローではなく、プロンプトの下書きです。
次に読むべきもの
Platform Agents と Data Skills - ソース特化版の Skills を示します。
Agent First アーキテクチャ - Skills が Agents と APIs の間のどこに位置するかを説明します。
UnifAPI Skills を見る - ライブの Skill ページを見られます。