boloforms-automation

boloforms-automation skill の概要

boloforms-automation ができること

boloforms-automation は、Composio の Rube MCP server 経由で Boloforms の操作を実行するための Claude skill です。価値の中心は、固定されたフォーム操作コマンドを持つことではありません。まず現在の Boloforms tool schema を検出し、ユーザーの Boloforms 接続を確認したうえで、タスクに合った MCP tool を実行する、という進め方をエージェントに徹底させる点にあります。

これは重要です。Composio toolkit の schema は変更される可能性があるためです。この skill の最大の差別化ポイントは、RUBE_SEARCH_TOOLS を使った「先に tools を検索する」ワークフローです。古い parameter 名や推測した API による失敗を減らせます。

この skill が向いているケース

boloforms-automation skill は、利用可能な Boloforms action の確認、フォーム自動化リクエストの準備、接続ステータスの確認、Rube MCP 経由でサポート済み操作を実行する、といった Boloforms 関連作業をエージェントに任せたい場合に役立ちます。

Claude または MCP 対応クライアントをすでに利用しており、tool call の承認に慣れているユーザーに特に向いています。一方で、フォーム設計についての一般的なアドバイスだけが必要な場合にはあまり適していません。この skill は汎用的な提案ではなく、ライブの MCP 実行を前提にしているためです。

導入前に確認すべき条件

この skill をインストールしたり、本格的に利用したりする前に、次の 3 点を確認してください。

• 利用しているクライアントが MCP servers に対応していること。
• Rube MCP が https://rube.app/mcp で設定されていること。
• toolkit boloforms を指定した RUBE_MANAGE_CONNECTIONS により、Boloforms 接続を有効化できること。

上流の skill はコンパクトで、含まれているのは SKILL.md のみです。追加の scripts、examples、reference files はありません。そのため中身は確認しやすい一方で、不足している業務コンテキストはプロンプト側で補う必要があります。

主なトレードオフ

この skill は、実行前に tool discovery を必須にすることで信頼性を高めます。ただし、ライブの Rube MCP が利用可能であり、Boloforms の認可が有効であることに依存します。どちらかが欠けている場合、エージェントはセットアップ手順を説明できますが、自動化そのものは完了できません。

boloforms-automation skill の使い方

boloforms-automation のインストール前提

ComposioHQ の skill collection から skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill boloforms-automation

次に、MCP 対応クライアントへ Rube MCP を追加します。

https://rube.app/mcp

MCP が利用可能になったら、RUBE_SEARCH_TOOLS が応答するかをエージェントに確認させます。続いて、toolkit boloforms を指定して RUBE_MANAGE_CONNECTIONS を使い、接続が ACTIVE でない場合は返された認可フローを完了してください。

skill に渡すべき入力

boloforms-automation を効果的に使うには、「フォームを自動化して」とだけ依頼しないようにします。次の情報を渡してください。

• 実現したい具体的な Boloforms 上の結果。
• 安全に共有できる form、workspace、account の文脈。
• データの読み取り、作成、更新、送信、エクスポート、監査のどれを行いたいか。
• field names、filters、date ranges、respondent criteria、destination details。
• 「本番フォームは変更しない」「送信前に確認する」などの制約。

弱いプロンプトの例:

Use Boloforms to update my form.

よりよいプロンプトの例:

Use boloforms-automation to discover current Boloforms tools, verify my connection, then find whether there is a supported action to update the confirmation message for the customer feedback form. Do not make changes until you show me the tool name, required fields, and proposed values.

推奨ワークフロー

次の実行パターンを使うのがおすすめです。

1. 具体的な Boloforms のユースケースについて、エージェントに RUBE_SEARCH_TOOLS を呼び出させる。
2. 返された tool slugs、schemas、pitfalls を確認する。
3. Boloforms 接続が ACTIVE であることを確認する。
4. データを変更する action の場合、実行前に正確な tool call payload をエージェントに下書きさせる。
5. required fields と target object が明確になってから tool を実行する。
6. 結果を確認し、追加の call が必要か判断する。

このワークフローは、update、delete、submission、notification のように、対象が曖昧だと誤ったフォームに影響する可能性があるタスクで特に重要です。

利用前に読むべきファイル

まず composio-skills/boloforms-automation/SKILL.md を確認してください。prerequisites、setup、tool discovery、中核となる workflow pattern など、運用上のガイダンスがすべて含まれています。この skill には README.md、rules/、resources/、references/、scripts は同梱されていないため、SKILL.md が唯一の信頼できる情報源です。

より広いエコシステムの文脈が必要な場合は、Composio の Boloforms toolkit documentation https://composio.dev/toolkits/boloforms も確認してください。ただし、現在実行可能な schema については、ライブの RUBE_SEARCH_TOOLS 出力を優先するのが安全です。

boloforms-automation skill FAQ

boloforms-automation は開発者専用ですか？

いいえ。AI クライアントが MCP に対応しており、Boloforms の認可フローを完了できるなら、開発者でなくても利用できます。ただし初心者は、変更を実行する前に、検出された tools と提案されている parameters をエージェントに表示させるべきです。

通常のプロンプトより何が優れていますか？

通常のプロンプトでは、存在する Boloforms API を推測してしまう可能性があります。boloforms-automation skill は、まず RUBE_SEARCH_TOOLS を呼び出すようエージェントに指示するため、思い込みではなく最新の Composio tool schemas に基づいて作業できます。これが、この skill をインストールする主な理由です。

この skill を使うべきでない場面は？

Rube MCP に接続できない場合、Boloforms を認可できない場合、またはフォーム用の一般的な文章作成だけが必要な場合は使うべきではありません。また、正確な identifiers、filters、approval checkpoints を提示できないのであれば、リスクの高い一括変更にも向きません。

すぐ使える自動化 scripts は含まれていますか？

いいえ。これは script package ではなく、MCP workflow skill です。Rube 経由で Boloforms tools を検出し呼び出すための信頼性の高い型を提供しますが、実際に利用できる action はライブの Composio toolkit response によって決まります。

boloforms-automation skill を改善する方法

よりよいプロンプトで boloforms-automation の結果を改善する

boloforms-automation の出力をすばやく改善するには、operation type と safety level を明確に指定するのが最も効果的です。例:

Discover available Boloforms tools for exporting recent responses from the event registration form. If an export tool exists, show the required schema, ask me for missing fields, and do not execute until I confirm the date range.

これにより、RUBE_SEARCH_TOOLS に渡す具体的なユースケースがエージェントに伝わり、早すぎる実行を防げます。また、不足している parameters も早い段階で見えるようになります。

防ぐべきよくある失敗

失敗の多くは、次の 4 つの原因のいずれかです。

• Rube MCP が設定されていない、または RUBE_SEARCH_TOOLS が利用できない。
• Boloforms が接続されていない、または接続が ACTIVE ではない。
• プロンプトに target form、fields、filters、desired action が含まれていない。
• エージェントが schema を先に検出せず、推測で進めてしまう。

実行に失敗した場合は、推測した parameters を編集するのではなく、tool discovery からやり直してください。

リスクのある操作には人間の承認を入れる

create、update、delete、publish、submit、notification のワークフローでは、preview step を必須にしてください。エージェントに次の内容を表示させます。

• 検出された tool slug。
• required input schema。
• 送信予定の正確な payload。
• 想定される効果の平易な説明。
• 取り消し不能、または広範囲に影響する可能性のあるリスク。

これにより、本番の Boloforms 作業でも skill をより安全に使いやすくなり、監査もしやすくなります。

最初の出力後に反復する

最初の tool result が返ってきたら、次のような的を絞った follow-up で調整します。

• “Filter that to responses submitted after Monday.”
• “Use the same discovered schema, but only read data this time.”
• “Explain which required field is missing before retrying.”
• “Prepare the update payload, but wait for approval.”

この skill は、最初の応答を最終的な自動化ステップとみなすのではなく、schema discovery と planning として扱うと最も効果を発揮します。