carbone-automation
作成者 ComposioHQcarbone-automation は、エージェントが Composio Rube MCP 経由で Carbone のワークフロー自動化を実行するためのスキルです。現在の tool schemas の確認、Carbone 接続の検証、ドキュメント関連タスクの安全な実行に役立ちます。
このスキルの評価は 68/100 です。ディレクトリ掲載には許容範囲ですが、完全な Carbone 自動化パッケージというより、軽量な MCP ワークフローガイドとして見せるのが適しています。ディレクトリ利用者は、どのような場面で使うべきか、エージェントがどう開始すべきかを把握できます。ただし、実際の Carbone 操作や schemas については、Rube のライブツール探索に依存する前提で考える必要があります。
- 有効な skill frontmatter により、`carbone-automation` の目的と `rube` MCP server への依存関係が明確に示されています。
- 前提条件とセットアップ手順では、エージェントが `RUBE_SEARCH_TOOLS` を確認し、`carbone` connection を管理し、実行前に ACTIVE status を確認する必要があることを説明しています。
- 最初にツールを検索して最新の schemas を確認するという明確な運用パターンが示されており、Composio の Carbone toolkit を使う際の stale-schema リスクを抑えられます。
- インストールコマンドや補助ファイルは提供されていません。導入には、利用者が自分のクライアントに Rube MCP endpoint を追加する方法をすでに理解していることが前提になります。
- ワークフローの案内は、主に汎用的なツール探索と接続設定にとどまっており、具体的な Carbone タスク例やエッジケースへの対応は限定的です。
carbone-automation skill の概要
carbone-automation でできること
carbone-automation は、Composio の Rube MCP server を通じて Carbone 関連のワークフロー自動化を実行するための Claude skill です。エージェントが現在の Carbone tool schema を確認し、Carbone 接続を検証したうえで、ツール名や古いパラメータを推測せずにドキュメント／レポート自動化タスクを実行できるようにします。
このスキルは、すでに Carbone を使っている、またはテンプレートベースのドキュメント生成に Carbone を使う予定があり、毎回 Composio toolkit docs を手作業で確認するのではなく、AI エージェントに MCP 経由で操作させたいユーザーに向いています。
向いているユースケース
テンプレートからのドキュメント生成、利用可能な Carbone 操作の確認、より大きなワークフロー自動化への Carbone 組み込みなど、タスクが稼働中の Carbone tooling に依存する場合は、carbone-automation skill が適しています。
特に次のような場合に有効です。
- MCP クライアントが Rube MCP tools をサポートしている。
- 実行前に、エージェントに現在の schema を確認させたい。
- Carbone アカウントや接続状態がセッションごとに変わる可能性がある。
- 単発のプロンプトではなく、「discover, connect, execute, verify」を繰り返せるワークフローにしたい。
導入時の重要な前提
主なハードルはスキルそのものではなく、外部ツール側のセットアップです。carbone-automation には Rube MCP と、Composio 経由の有効な Carbone 接続が必要です。上流のスキルは rube MCP server に明示的に依存しており、RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS が利用できることを前提にしています。
環境から https://rube.app/mcp に接続できない場合、または Carbone toolkit を認可できない場合、このスキルで実際の Carbone 操作を行うことはできません。
carbone-automation skill の使い方
carbone-automation のインストールとセットアップ手順
Composio skill collection からスキルをインストールします。
npx skills add ComposioHQ/awesome-claude-skills --skill carbone-automation
次に、AI クライアントで Rube MCP を設定し、以下を追加します。
https://rube.app/mcp
元のスキルでは、MCP endpoint の追加に API key は不要とされています。ただし、Carbone toolkit には有効な接続が必要です。MCP が利用可能になったら、まず RUBE_SEARCH_TOOLS が応答することをエージェントに確認させ、その後 carbone toolkit に対して RUBE_MANAGE_CONNECTIONS を呼び出します。接続状態が ACTIVE でない場合は、Carbone の実行を依頼する前に、返された認可フローを完了してください。
スキルに渡すべき入力
carbone-automation を効果的に使うプロンプトには、業務上の目的、想定している Carbone object または operation、テンプレートやドキュメントの文脈、入力データの形、出力形式、成功条件を含めるのが理想です。
弱いプロンプト:
Generate my report with Carbone.
より良いプロンプト:
Use the carbone-automation skill. First discover current Carbone tools with
RUBE_SEARCH_TOOLS. Check that thecarboneconnection is active. I need to generate a PDF invoice from a Carbone template. The data includes customer name, invoice number, line items, tax, and total. Tell me which tool schema you found before executing, and stop if required fields are missing.
このように書くと、エージェントは先に schema を探索し、接続状態を確認し、存在しないパラメータを作り出さないように動けます。
実タスクで推奨されるワークフロー
Workflow Automation で carbone-automation を安定して使うには、次の流れを使います。
- 単に “Carbone operations” と頼むのではなく、具体的な Carbone タスクを指定して
RUBE_SEARCH_TOOLSを呼び出すよう依頼する。 - 実行前に、利用可能な tool slug、必須フィールド、リスクを要約させる。
RUBE_MANAGE_CONNECTIONSで Carbone 接続を確認する。- 不足している template ID、file reference、data payload、出力設定を渡す。
- schema と接続が確認できてから、選択した tool を実行する。
- 返された結果を確認し、失敗した場合は構造化されたトラブルシューティング要約を依頼する。
このスキルで最も重要なルールは、最初に tool を検索することです。Rube の schema は変わる可能性があり、このスキルは古い tool call を防ぐために設計されています。
最初に読むべきリポジトリファイル
リポジトリのパスは次のとおりです。
composio-skills/carbone-automation/SKILL.md
提供されているファイルツリーには、追加の resources/、references/、scripts/、README.md はありません。そのため、SKILL.md が主要な情報源です。前提条件、セットアップ、tool discovery、中心となるワークフローパターンを確認してください。外部機能の詳細については、composio.dev/toolkits/carbone にある Composio toolkit docs を参照できますが、tool schema については実際の RUBE_SEARCH_TOOLS の出力を最終的な根拠として扱ってください。
carbone-automation skill FAQ
carbone-automation は開発者専用ですか？
開発者専用ではありませんが、MCP ベースの自動化やアカウント認可フローに慣れているユーザーのほうが使いやすいスキルです。MCP クライアントがすでに設定済みで、テンプレート名、データフィールド、希望する出力など、ドキュメント生成に必要な具体情報を提供できるなら、非開発者でも利用できます。
通常の Carbone プロンプトより何が優れていますか？
通常のプロンプトでもやりたいことは説明できますが、Carbone の tool 名を幻覚したり、認証チェックを省いたり、古いパラメータを使ったりする可能性があります。carbone-automation skill は、運用上もっとも重要な習慣を組み込んでいます。つまり、RUBE_SEARCH_TOOLS で現在の tool を確認し、Carbone 接続をチェックし、返された schema に基づいて実行する、という流れです。
carbone-automation をインストールしないほうがよい場合は？
Carbone テンプレートに関する一般的な助言だけが必要な場合、クライアントが Rube MCP をサポートしていない場合、または Composio 経由で Carbone 接続を認可できない場合は、インストールしないほうがよいでしょう。実際の Carbone tool 実行を必要としないワークフローにも不要です。
すぐ使えるスクリプトやテンプレートは含まれていますか？
いいえ。提供されているリポジトリ上の情報では、単一の SKILL.md のみがあり、scripts/、resources/、references/ のようなサポートフォルダはありません。このスキルの価値は、同梱テンプレートや補助コードではなく、MCP ワークフローパターンにあります。
carbone-automation skill を改善する方法
schema を意識した詳細なプロンプトにする
carbone-automation でより良い結果を得るには、最初の依頼を説明文ではなく、実行手順を意識した内容にします。含めるべき情報は次のとおりです。
- 実行したい正確な Carbone タスク。
- 既知の template ID、document name、file reference。
- 想定している入力データ構造。
- 出力形式、命名規則、保存先。
- エージェントがすぐ実行すべきか、確認を待つべきか。
これにより、やり取りの回数を減らし、RUBE_SEARCH_TOOLS がより関連性の高い tool plan を返しやすくなります。
よくある失敗を防ぐ
よくある問題は、MCP アクセスがない、Carbone の認可が有効でない、タスク説明が曖昧、tool discovery を飛ばしてしまう、というものです。実行前に発見した schema をエージェントに提示させることで防げます。
有効なガードレール用プロンプトは次のとおりです。
Do not call any Carbone execution tool until you have searched tools for this exact use case, checked the
carboneconnection status, and listed required fields I still need to provide.
初回出力後に改善を重ねる
初回実行後に、単に「直して」と言うだけでは不十分です。返されたエラー、使用した tool slug、必須フィールド、payload の要約、期待していた結果を伝えてください。そのうえで、失敗した call を RUBE_SEARCH_TOOLS の最新 schema と照合するようエージェントに依頼します。
良い改善依頼の例:
The Carbone call failed with this error: [paste error]. Re-run tool discovery for the same use case, compare the required schema with the payload used, identify the mismatch, and propose the smallest corrected call.
スキル自体を改善する
fork を保守している場合、価値が高い改善は、よくある Carbone ワークフローの例、テンプレートベースの PDF 生成向けサンプルプロンプト、非アクティブな接続や不足フィールドに関するトラブルシューティングメモの追加です。現在のスキルはコンパクトなので、検証済みの例を追加すると、中心となる「discover first」の設計を変えずに、carbone-automation ガイドを導入しやすくできます。