bonsai-automation
作成者 ComposioHQbonsai-automation は、Claude が Composio Rube MCP を通じて Bonsai 操作を自動化するための skill です。skill をインストールし、Rube を接続して Bonsai 連携を確認したうえで、ワークフロー実行前にスキーマ優先のツール探索を行います。
この skill の評価は 66/100 で、掲載には問題ありませんが、すでに Rube MCP と Bonsai を利用しているユーザーに特に向いています。エージェントが正しく開始するためのトリガーとセットアップ手順は十分に示されています。一方で、ディレクトリ利用者は、運用上の詳細の多くが埋め込みの例や補足ドキュメントではなく、実行時のツール探索に委ねられている点を理解しておく必要があります。
- トリガーと対象範囲が明確です。Rube MCP 経由で Composio の Bonsai toolkit を使い、Bonsai 操作を自動化する用途だと明示されています。
- Rube MCP が利用可能であること、有効な Bonsai 接続があること、最新スキーマ取得のために最初に RUBE_SEARCH_TOOLS を呼び出す必要があることなど、運用前提が示されています。
- セットアップと探索の流れにより、エージェントは Rube の確認、Bonsai 接続の管理、ツール検索、返されたスキーマに基づく実行という再現しやすい手順を取れます。
- サポートファイル、スクリプト、リファレンスドキュメント、インストールコマンドは用意されていません。この skill は単一の SKILL.md と外部の Rube/Bonsai スキーマに全面的に依存します。
- ワークフローの案内は主に汎用的なツール探索と接続設定で、リポジトリ上の根拠としては、具体的な Bonsai タスク例やエッジケース対応は限られています。
bonsai-automation skill の概要
bonsai-automation ができること
bonsai-automation は、Composio の Rube MCP server を通じて Bonsai の業務オペレーションを実行するための Claude skill です。Bonsai の現在の tool schema をエージェントに確認させ、Bonsai 接続を検証したうえで、記憶頼みで API フィールドを推測するのではなく、bonsai toolkit 経由でタスクを実行したいユーザー向けに設計されています。
この skill で最も重要なのは手順です。必ず最初に RUBE_SEARCH_TOOLS を呼び出します。Rube の tool 名、入力項目、実行計画は変わる可能性があり、Bonsai のワークフローは最新の schema 詳細に依存することが多いためです。
相性のよいユーザーとワークフロー自動化のユースケース
最も向いているのは、すでに Bonsai を使っていて、Rube MCP 経由で接続する意思があるユーザーです。典型的な bonsai-automation for Workflow Automation の使い方は、エージェントに利用可能な Bonsai action を調べさせ、安全な実行計画を作らせ、アクティブな接続と必須フィールドを確認したあとで、client、project、invoice、task などの業務管理操作を実行させる、という流れです。
これは汎用的な Bonsai の使い方ガイドではありません。「Bonsai の仕組みを説明してほしい」ではなく、「承認済みの MCP tools を通じて Claude に Bonsai を操作させたい」場合に特に役立ちます。
主な差別化ポイント: schema-first execution
通常のプロンプトでは、Claude に「Bonsai で invoice を作成して」と依頼できますが、モデルが tool の引数を作り上げたり、古い前提で処理したりする可能性があります。bonsai-automation skill は、次の discovery パターンを強制することで、そのリスクを下げます。
- 対象の Bonsai タスクに使える Rube tools を検索する。
bonsaitoolkit の接続がアクティブか確認する。- 返された schema と注意点を読む。
- 現在の tool 定義に一致するフィールドだけで実行する。
この schema-first の流れこそが、この skill をインストールする主な理由です。
bonsai-automation skill の使い方
bonsai-automation のインストールと MCP 設定
Composio skill collection から次のコマンドで skill をインストールします。
npx skills add ComposioHQ/awesome-claude-skills --skill bonsai-automation
この skill が必要とするのはローカルのスクリプト群ではなく、Rube MCP です。クライアント設定で https://rube.app/mcp を MCP server として追加し、MCP tools が表示されることを確認してください。リポジトリ内で必ず読むべきソースファイルは composio-skills/bonsai-automation/SKILL.md のみです。追加で確認すべき scripts/、resources/、rules/ フォルダはありません。
有用な出力を期待する前に、次を確認してください。
RUBE_SEARCH_TOOLSが利用できる。RUBE_MANAGE_CONNECTIONSで toolkit connections を管理できる。bonsaiconnection がACTIVEになっている。- 非アクティブな場合は、Bonsai action を実行する前に、返された認証フローを完了する。
実務で使いやすい bonsai-automation の利用パターン
信頼しやすい bonsai-automation usage の流れは次のとおりです。
- 実現したい Bonsai 上の結果をエージェントに具体的に伝える。
- そのタスクに対して
RUBE_SEARCH_TOOLSを呼び出すよう依頼する。 - 利用可能な tool slug、必須フィールド、任意フィールド、既知の注意点を要約させる。
RUBE_MANAGE_CONNECTIONSで Bonsai 接続を確認させる。- 不足している業務上の詳細を入力する。
- 計画が意図と一致していることを確認してから実行を承認する。
よいプロンプト例:
“Use bonsai-automation to help create a Bonsai invoice for client Acme Ltd for the completed website audit. First search Rube tools for the current Bonsai invoice schema, then check that the bonsai connection is active. Before executing, show me the required fields, any assumptions, and the exact values you plan to send.”
これは「make me an invoice」よりも有効です。目的、対象となる entity 名、承認条件、必要な discovery 手順が明確に含まれているためです。
出力品質を高める入力情報
最良の結果を得るには、tool が安全に推測できない業務情報を明示します。
- Bonsai object type: client、project、invoice、proposal、task、payment、time entry。
- すでに分かっている名前や ID。
- 日付、通貨、line items、数量、単価、税の扱い、支払期限。
- エージェントに draft、search、update、execute のどれをしてほしいか。
- 「送信前に確認する」「既存 invoice は変更しない」「まず一致する record を表示する」などの確認ルール。
正確な Bonsai ID が分からない場合は、先に検索して候補を提示するようエージェントに依頼してください。検索結果が明確でない限り、名前だけを根拠に record を更新・削除させる依頼は避けるべきです。
最初に読むべきリポジトリファイル
まず composio-skills/bonsai-automation/SKILL.md にある SKILL.md から読み始めます。重要なセクションは Prerequisites、Setup、Tool Discovery、Core Workflow Pattern です。ファイル自体は簡潔ですが、導入判断に直結する重要点を見落としやすいです。つまり、tool discovery は任意ではありません。RUBE_SEARCH_TOOLS を省略するエージェントのワークフローは、この skill の安全モデルに従っていないことになります。
bonsai-automation skill FAQ
bonsai-automation は初心者にも役立つ？
はい。Rube MCP に接続し、Bonsai を認可できるなら役立ちます。この skill は Rube の現在の schema に基づくため、生の API 呼び出しを書くよりも初心者にとって安全な進め方になります。ただし、依頼する業務アクションの意味はユーザー側で理解している必要があります。エージェントはフィールドを discovery できますが、invoice の条件、client の同一性、承認ポリシーを入力なしに判断することはできません。
通常の Bonsai プロンプトと何が違う？
通常のプロンプトは、モデルの一般知識に依存します。bonsai-automation は、RUBE_SEARCH_TOOLS による live MCP discovery を使い、その後 RUBE_MANAGE_CONNECTIONS で Bonsai 接続を管理するようエージェントに指示します。そのため、誤ったフィールド、古い schema、無効な認証が実行を妨げるような実運用のワークフロー自動化に向いています。
bonsai-automation を使わないほうがよい場面は？
Bonsai 製品のアドバイス、会計上の助言、手動 UI 操作の案内だけが必要な場合は使う必要はありません。また、厳密なレビュー手順、record の照合ルール、確認ゲートを追加しない限り、リスクの高い一括変更にも向きません。この skill は実行支援のためのものであり、業務上のレビューを代替するものではありません。
Composio または Rube MCP は必須？
はい。この skill は、Rube MCP 経由で公開される Composio の Bonsai toolkit を前提に作られています。クライアントが https://rube.app/mcp に接続できない、または RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS を利用できない場合、中心となるワークフローは意図どおりに動きません。
bonsai-automation skill を改善する方法
実行制約を入れて bonsai-automation プロンプトを改善する
bonsai-automation の結果を最も早く改善する方法は、discovery、planning、execution を分けることです。例:
“Search Bonsai tools for updating a project status. Do not execute yet. Show required fields, matching project candidates, and the proposed update payload. Ask for confirmation before running the tool.”
これにより、エージェントが曖昧な意図からすぐに本番変更へ進んでしまうのを防げます。
注意すべきよくある失敗パターン
導入時につまずきやすいのは、Bonsai 認可が非アクティブなままになっている、tool discovery を省略している、record の照合が曖昧、必須フィールドが不足している、といった点です。エージェントが止まった場合は、同じ広い依頼を再試行するのではなく、どのステップで失敗したのかを具体的に報告させてください。MCP availability、Bonsai connection status、schema discovery、missing input、execution error のどれかを切り分けるほうが有用です。
最初の tool 結果をもとに反復する
最初の出力後は、推測ではなく Rube から返された根拠に基づいて調整します。schema に予想外の必須フィールドが含まれている場合は、その値を明示的に入力します。検索で複数の Bonsai records が返った場合は、ID または識別できる詳細で 1 つを選びます。実行計画にリスクの高い操作が含まれている場合は、まず read-only lookup を依頼してください。
skill をさらに強くするために必要なこと
上流の skill は、よく使う Bonsai 操作の task prompt 例、明示的な read-before-write ガイダンス、invoice、payment、record update 向けの confirmation gate 例があると、さらに実用性が高まります。それらが追加されるまでは、ユーザー側で RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、schema review、実行前の human approval を軸に、自分用のチェックリストを作るのがよいでしょう。