convertapi-automation
作成者 ComposioHQconvertapi-automation は、Claude が Composio Rube MCP を通じて ConvertAPI のフォーマット変換ワークフローを実行できるようにするスキルです。ツール探索、接続確認、スキーマに基づく実行をサポートします。
スコア: 66/100。ディレクトリ掲載には許容範囲ですが、内容は限定的です。ConvertAPI タスクに対して、エージェントが使うべきトリガーと Rube ベースの実行パターンは十分に示されています。一方で、具体的な操作の詳細の多くは実行時のツール探索に委ねられています。すでに Rube MCP を使っており、軽量な ConvertAPI automation wrapper が欲しいユーザーには検討価値がありますが、自己完結したワークフローライブラリを期待すべきではありません。
- 有効な frontmatter で `rube` MCP 要件が明確に宣言されており、Composio/Rube 経由の ConvertAPI automation であることも説明されています。
- 前提条件とセットアップ手順で、必要な Rube MCP endpoint、ConvertAPI connection、ACTIVE connection check が示されています。
- 現在の ConvertAPI tool usage でスキーマを推測するリスクを減らすため、エージェントにまず `RUBE_SEARCH_TOOLS` を呼び出すよう繰り返し案内しています。
- サポートファイル、スクリプト、README、インストールコマンドは含まれていません。導入の可否はほぼ SKILL.md の内容に依存します。
- このスキル自体には具体的な ConvertAPI の操作やスキーマが記載されていないため、実行前にエージェントが live RUBE_SEARCH_TOOLS discovery に頼る必要があります。
convertapi-automation skill の概要
convertapi-automation ができること
convertapi-automation は、Composio の Rube MCP サーバー経由で ConvertAPI の形式変換ワークフローを実行するための Claude skill です。ツール名を推測したり、リクエスト形式を固定で書いたりするのではなく、まず現在の ConvertAPI ツールスキーマを検出し、ユーザーの ConvertAPI 接続を確認したうえで、Rube を通じて変換タスクを実行するようエージェントに指示します。
そのため convertapi-automation skill は、ConvertAPI の使い方を説明してもらうだけでなく、繰り返し発生するファイル変換作業を AI エージェントに手伝わせたい場合に特に役立ちます。
向いているユーザーと用途
convertapi-automation は、ドキュメント、画像、スプレッドシート、プレゼンテーション、その他 ConvertAPI が対応するファイル形式を変換するワークフローで、Claude に安全にツール呼び出しを組み立ててほしい場合の Format Conversion に適しています。すでに MCP 対応クライアントを利用していて、ツール検出、接続確認、実行計画をエージェントに任せたいユーザーに向いています。
特に、「この DOCX を PDF に変換する」「アップロードした画像を 1 つの PDF にまとめる」「複数ファイルの一括変換ワークフローを準備する」といった作業に向いています。ただし、必要な ConvertAPI 操作が現在の Composio toolkit から利用できることが前提です。
この skill の違い
最大の特徴は、「まずツールを検索する」というルールです。上流の skill では、実行前に必ず RUBE_SEARCH_TOOLS を使うことが明示されており、エージェントが古い例ではなく現在のスキーマに基づいて処理できるようになっています。MCP のツール名、パラメータ、受け付ける入力形式は変わる可能性があるため、この点は重要です。
この skill は小さく、用途も絞られています。追加のスクリプト、サンプル、参照用フォルダはありません。価値の中心は、ConvertAPI automation のために正しい Rube MCP ワークフローを徹底させることにあります。
導入前に確認すべき制約
インストール前に、利用しているクライアントが MCP に対応していること、Rube MCP を追加できること、RUBE_MANAGE_CONNECTIONS 経由で ConvertAPI 接続を認証できることを確認してください。単体で動く CLI コンバーター、オフライン変換、または豊富な補助スクリプトを含むリポジトリが必要な場合、この skill はその用途にはかなり薄い構成です。
convertapi-automation skill の使い方
convertapi-automation のインストール前提
通常の skills ワークフローで、ComposioHQ/awesome-claude-skills リポジトリから skill をインストールします。例:
npx skills add ComposioHQ/awesome-claude-skills --skill convertapi-automation
次に、AI クライアントに Rube MCP を設定します。追加する URL は次のとおりです。
https://rube.app/mcp
この skill には Rube tools が必要で、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS が重要です。インストール後、エージェントに変換を依頼する前に、RUBE_SEARCH_TOOLS が応答することを確認してください。
必要な接続確認とツール検出フロー
convertapi-automation の使い方としては、次の流れが適切です。
- 特定の ConvertAPI タスクについて、エージェントに
RUBE_SEARCH_TOOLSを呼び出させる。 RUBE_MANAGE_CONNECTIONSで ConvertAPI 接続を確認させる。- 接続が
ACTIVEでない場合は、返された認証フローを完了する。 - 検出されたスキーマを使って、選択した ConvertAPI ツールをエージェントに実行させる。
- 返されたファイル、URL、または変換結果を確認する。
ツール検出を省略しないでください。この skill の中核となる指示は、まずツールを検索することです。最新の tool slug とパラメータスキーマは、記憶ではなく Rube から取得すべきだからです。
変換結果を良くするプロンプト
弱いプロンプトの例:
Convert my file to PDF.
convertapi-automation に適した、より強いプロンプトの例:
Use convertapi-automation. First run
RUBE_SEARCH_TOOLSfor “convert DOCX to PDF with preserved layout.” Check my ConvertAPI connection status. If active, convert the attachedcontract.docxto PDF. Preserve formatting, return the output file link, and tell me which tool slug and required fields were used.
一括処理や本番運用に近い作業では、変換元形式、変換先形式、ファイル数、ファイルが添付なのか URL ベースなのか、出力ファイル名のルール、ページサイズ、OCR、圧縮、画像解像度、レイアウト保持などの品質要件を含めてください。
最初に読むべきリポジトリ内ファイル
この skill で重要なソースファイルは 1 つです。
composio-skills/convertapi-automation/SKILL.md
必要な MCP サーバー、接続ワークフロー、ツール検出パターンを確認するために、このファイルを読んでください。同梱のスクリプトやサンプルはないため、セットアップの確信は、利用している MCP クライアントが Rube tools を公開できるか、ConvertAPI 認証が成功するかで判断することになります。
convertapi-automation skill FAQ
convertapi-automation は ConvertAPI 専用ですか？
はい。この skill は、Rube MCP 経由で Composio の ConvertAPI toolkit を使う ConvertAPI 操作に範囲が限定されています。汎用的なファイル変換フレームワークではなく、LibreOffice、ImageMagick、Pandoc などのローカルコンバーターを追加するものでもありません。
Rube MCP なしで使えますか？
いいえ。この skill は rube への MCP 依存関係を宣言しています。RUBE_SEARCH_TOOLS が利用できない場合、この skill 自身が求めるセットアップと検出フローに従えません。その場合でも、通常のプロンプトで変換計画を説明することはできるかもしれませんが、この skill 経由で ConvertAPI 操作を実行することはできません。
通常のプロンプトより何が良いのですか？
通常のプロンプトでは、ConvertAPI のパラメータを作り上げてしまったり、古い例に依存したりする可能性があります。convertapi-automation は、まず現在のツールを検出し、アクティブな接続を確認し、返されたスキーマを使うようエージェントに指示します。これにより、実際のツール実行に依存する作業で推測を減らせます。
この skill を使わないほうがよいケースは？
オフライン変換、厳密なデータローカル処理、カスタム後処理スクリプト、またはリトライやログ記録まで実装済みの本格的なバッチパイプラインが必要な場合は使わないほうがよいでしょう。convertapi-automation skill は軽量な実行ガイドであり、完成された変換アプリケーションではありません。
convertapi-automation skill を改善する方法
ツールを疑う前に入力を改善する
結果が悪い原因の多くは、変換依頼の条件が不足していることです。変換元形式、変換先形式、ファイルの場所、希望する出力名、品質上の制約、特別なオプションをエージェントに伝えてください。例:
Convert three attached PNG files into one PDF, in filename order, A4 portrait, no compression if avoidable, and return one downloadable output.
これは「make a PDF」より有効です。検出された ConvertAPI ツールが、意図を適切なフィールドに対応付けやすくなるためです。
よくある失敗パターンを確認する
よくあるブロッカーには、Rube MCP が設定されていない、ConvertAPI 接続がアクティブでない、変換元と変換先の組み合わせが非対応、ファイルにアクセスできない、RUBE_SEARCH_TOOLS を省略したことによるスキーマ不一致などがあります。初回実行に失敗した場合は、再試行の前に、検出された tool slug、必須フィールド、指定したフィールド、正確な接続ステータスをエージェントに報告させてください。
初回出力後に調整する
最初の変換後、レイアウト、サイズ、解像度、テキスト抽出、ページ順を確認してください。そのうえで、具体的な修正を加えてプロンプトを改善します。
Retry with higher image quality and keep the original page dimensions.
または
The output order is wrong; sort files by numeric suffix before converting.
こうすることで、convertapi-automation を一度きりのコンバーターではなく、制御されたワークフローとして使えるようになります。
convertapi-automation 向けのチーム固有ガイドを追加する
チームでこの skill を頻繁に使う場合は、承認済み形式、命名規則、保存先、プライバシールール、リトライ方針を自分たちのプロジェクト指示に記録してください。上流の skill は意図的に最小構成に保たれているため、ローカルのガイダンスを追加することで、核となる「検出、接続、実行」のパターンを変えずに、安全性と一貫性を高められます。