metaphor-automation
作成者 ComposioHQmetaphor-automation は、エージェントが Composio Rube MCP 経由で Metaphor ワークフローを実行できるようにする skill です。実行前に現在利用できるツールを発見し、接続状態を確認し、ライブスキーマを参照してから処理を進めます。
この skill の評価は 67/100 です。掲載には十分ですが、完成度の高いワークフローパックというより、軽量なコネクタ型 skill として紹介するのが適切です。ディレクトリ利用者は、Rube MCP 経由で Metaphor を自動化したい場面で導入すべきか判断できます。ただし、具体的な操作やスキーマについては、ライブのツール発見と外部ツールキットのドキュメントに依存する前提です。
- トリガーと対象範囲が明確です。Rube MCP 経由で Composio の Metaphor toolkit を使い、Metaphor 操作を自動化するための skill です。
- Rube MCP が利用可能であること、有効な Metaphor 接続があること、実行前に最新スキーマ取得のため RUBE_SEARCH_TOOLS を呼び出す必要があることなど、運用上の前提条件が明示されています。
- ツール発見、接続確認、スキーマに基づく利用という基本的な実行パターンが示されており、汎用プロンプトだけで進める場合に比べて迷いを減らせます。
- ワークフローの案内は、具体的な Metaphor タスク例やよく使う操作を示すというより、Rube MCP のツール発見／実行手順に寄った汎用的な内容です。
- SKILL.md 以外にサポートファイル、README、インストールコマンド、ローカル参照がないため、導入には利用者が Rube MCP と Metaphor/Composio の接続を理解していることが前提になります。
metaphor-automation skill の概要
metaphor-automation でできること
metaphor-automation は、Composio の Rube MCP レイヤーを通じて Metaphor タスクを実行するための Claude skill です。古いツール名やスキーマを決め打ちするのではなく、まず現在利用できる Metaphor ツールをエージェントに発見させ、ユーザーの Metaphor 接続を確認したうえで、Rube が返したスキーマに沿って選択した操作を実行します。
そのため metaphor-automation skill は、いま存在する MCP ツールを推測せず、AI エージェントに Metaphor を安定して操作させたい場合に特に役立ちます。
Workflow Automation ユーザーに向いているケース
Workflow Automation で metaphor-automation を使うべきなのは、検索、取得、エンリッチメント、または Composio 経由で Metaphor 管理データに対して何らかの処理を行う、といった反復可能なプロセスの一部としてエージェントが Metaphor を呼び出す必要がある場合です。MCP 対応クライアントをすでに利用しており、Rube 経由で Metaphor 接続を認可できるユーザーに最も適しています。
単体のプロンプト集としては、あまり大きな価値はありません。この skill の価値は、RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、そして Composio から公開される Metaphor toolkit へのライブ MCP アクセスにあります。
主な違い: まずスキーマを発見する設計
この skill の最も強い設計上の特徴は、実行前に必ずエージェントへ RUBE_SEARCH_TOOLS を呼び出させる点です。これは重要です。MCP ツールのスキーマは変わる可能性があり、利用できるアクションはアカウントによって異なる場合があり、古いサンプルに基づく呼び出しは失敗につながるからです。
インストール判断の観点では、これは実用的なガードレールです。metaphor-automation は Metaphor の API を暗記させるためのものではありません。ワークフローを実行する前に、現在のツール一覧、入力スキーマ、実行計画、注意点を Rube に確認するようエージェントに教える skill です。
インストール前に確認すること
インストール前に、自分の環境で Rube MCP を利用できること、そして Metaphor toolkit 接続の認可に問題がないことを確認してください。上流の skill はコンパクトで、中心は SKILL.md です。バンドルされたスクリプト、サンプル、リソース、テスト fixture はありません。導入はシンプルですが、そのぶん skill が推測できないタスク詳細は、ユーザー側のプロンプトで明確に指定する必要があります。
metaphor-automation skill の使い方
metaphor-automation のインストール前提
利用している skill manager のリポジトリパスから skill をインストールします。例:
npx skills add ComposioHQ/awesome-claude-skills --skill metaphor-automation
次に、AI クライアントへ Rube MCP を追加します。
https://rube.app/mcp
この skill には rube MCP server が必要です。実際に metaphor-automation を使える状態か判断するには、まず RUBE_SEARCH_TOOLS が利用可能か確認してください。MCP server がない場合、skill はワークフローを説明することはできますが、Metaphor のアクションは実行できません。
初回実行前に必要なセットアップ
通常、正常に実行するには次の順序で進めます。
RUBE_SEARCH_TOOLSが応答することを確認する。- toolkit
metaphorを指定してRUBE_MANAGE_CONNECTIONSを使う。 - 接続が
ACTIVEでなければ、返された認可リンクを開く。 - エージェントにタスク実行を依頼する前に、接続ステータスを再確認する。
- 単に「Metaphor operations」ではなく、自分の具体的な Metaphor ユースケースに対してツール検索を依頼する。
導入時の主な障害は接続状態です。多くの失敗はプロンプト品質の問題ではなく、MCP アクセスがないこと、または Metaphor 接続が inactive であることに起因します。
粗い目的を実行可能なプロンプトに変える
弱いプロンプト:
Use Metaphor to find some data.
より良いプロンプト:
Use the metaphor-automation skill. First call
RUBE_SEARCH_TOOLSfor the exact use case: “find recent Metaphor records matching [topic/entity/filter] and return the top results with source fields.” Check the Metaphor connection withRUBE_MANAGE_CONNECTIONS. Use only the schema returned by Rube. Before executing, summarize the chosen tool, required inputs, optional filters, and any missing information you need from me.
このように書くと、操作の種類、対象となる entity や topic、期待する結果の形、そして存在しないフィールドを作らないというルールがエージェントに伝わるため、出力が改善します。自動化で使う場合は、件数上限、日付範囲、重複排除ルール、出力形式、結果が見つからなかった場合の扱いも追加してください。
最初に読むべきリポジトリ内ファイル
まず composio-skills/metaphor-automation/SKILL.md を確認してください。このファイルに skill 全体がまとまっています。前提条件、セットアップ、ツール発見、接続確認、そして中核となるワークフローパターンが含まれています。現在の skill パスには、個別の README.md、scripts/、references/、resources/ フォルダはありません。そのため、別の場所に隠れた実装詳細があるとは想定しないでください。
製品面の背景をさらに確認したい場合は、skill からリンクされている Composio の Metaphor toolkit ドキュメントを参照してください: https://composio.dev/toolkits/metaphor
metaphor-automation skill FAQ
Rube MCP なしで metaphor-automation は使えますか？
いいえ。metaphor-automation skill は、クライアント側で Rube MCP が利用できることに依存しています。RUBE_SEARCH_TOOLS がなければ、最も重要な動作である現在の Metaphor ツールとスキーマの発見ができません。RUBE_MANAGE_CONNECTIONS がなければ、Metaphor toolkit が認可済みかどうかをエージェントが確認することもできません。
普通のプロンプトより何が優れていますか？
通常のプロンプトでも、モデルに「Metaphor を使って」と依頼することはできます。しかし、その場合はツール名、古いパラメータ、サポートされていないアクションを幻覚する可能性があります。metaphor-automation は、ツールを発見し、接続を確認し、スキーマを確認してから選択したツールを実行する、より安全な実行パターンをエージェントに与えます。そのため、静的な指示だけよりも、ライブの Workflow Automation で信頼性を高めやすくなります。
初心者にも向いていますか？
AI クライアントに MCP server を追加する方法をすでに理解しているなら、初心者にも扱いやすい skill です。一方で、MCP や OAuth 型のツール接続を一度も設定したことがないユーザーには最適とは言えません。skill のドキュメントは短いため、初心者は Rube の接続フローに沿って進め、実行前に返された各ツールスキーマをエージェントに説明させる前提で使うとよいでしょう。
この skill を使わないほうがよい場面は？
Metaphor について一般的なブレインストーミングだけをしたい場合、利用中のクライアントが MCP server に接続できない場合、またはこの skill が提供していないローカルスクリプトや検証処理がワークフローに必要な場合は、metaphor-automation を使うべきではありません。また、固定された監査済みの API wrapper が必要な場合にも向いていません。この skill は意図的に、Rube によるライブのツール発見に依存しています。
metaphor-automation skill を改善する方法
metaphor-automation の入力を改善する
最も良い結果を得るには、タスクの切り出し方を具体的にすることが重要です。次の情報を含めてください。
- 実行したい Metaphor 操作の正確な内容
- entity 名、検索語、フィルター、ID
- 期待する出力フィールド
- 結果件数の上限と並び順の希望
- エージェントが実行してよいのか、計画作成のみに留めるのか
- 希望するフィールドがスキーマにない場合のフォールバック動作
これにより、不要なツール検索を減らし、広い調査依頼を実行可能な自動化ステップとしてエージェントが誤解するのを防げます。
よくある失敗を避ける
よくある失敗は、ツール発見の省略、inactive な接続、推測されたスキーマ、曖昧なユーザー目標です。エージェントには明示的に次のように伝えてください。
Do not call any Metaphor tool until
RUBE_SEARCH_TOOLShas returned the current schema andRUBE_MANAGE_CONNECTIONSconfirms an active Metaphor connection.
呼び出しが失敗した場合は、エージェントに記憶や古いサンプルではなく、Rube が返したスキーマと実際に試した入力を比較させてください。
初回出力のあとに改善する
初回実行後は、選択した tool slug、使用した必須フィールド、省略した任意フィールド、返されたエラー、次に推奨される呼び出しを含む実行メモを依頼して、ワークフローを改善してください。これにより、単発の実行をチームで再利用できる metaphor-automation ガイドに変えられます。
繰り返し使うワークフローでは、必要なフィルター、出力形式、承認チェックポイントを含む成功したプロンプトパターンを保存しておきましょう。
自分の環境向けに安全に拡張する
fork を管理している場合は、実際のユースケースに合うサンプルを追加してください。検索テンプレート、接続確認スニペット、期待する出力、エラーハンドリングルールなどです。中核である「まずツールを検索する」動作は維持してください。最大の改善は文章量を増やすことではありません。組織固有のプロンプトを追加し、ツール発見をより的確にし、実行時の曖昧さを減らすことです。