formbricks-automation

formbricks-automation skill の概要

formbricks-automation の用途

formbricks-automation は、Composio の Rube MCP toolkit を通じて Formbricks の操作を自動化するための Claude skill です。記憶に頼って API フィールドを推測するのではなく、まず現在利用できる Rube tools と schemas を確認したうえで、Formbricks のデータや設定をエージェントに扱わせたいユーザー向けに設計されています。

向いているユーザーと作業

すでに Formbricks を使っていて、適切な Formbricks tool の特定、接続状態の確認、tool call の準備、Rube MCP 経由での反復可能なワークフロー実行といった運用作業を AI エージェントに支援させたい場合に、この skill は適しています。特に、稼働中の survey、プロダクトフィードバック、顧客調査ワークスペースをエージェントに触らせる前に、インストール可否や運用上の前提を確認したいチームに有用です。

主な差別化ポイント：schema discovery を先に行う

formbricks-automation skill の重要な挙動は、Formbricks actions の固定リストを持つことではありません。実行前に RUBE_SEARCH_TOOLS を呼び出し、現在の tool slugs、input schemas、execution plans、pitfalls を取得するようエージェントに指示します。MCP tool の表面仕様は変わる可能性があり、古い前提に基づく推測は自動化失敗のよくある原因になるため、この点は重要です。

導入時の重要な制約

これは単体で動作する Formbricks client ではありません。Rube MCP が利用可能であり、formbricks toolkit を使って RUBE_MANAGE_CONNECTIONS 経由の Formbricks connection が有効になっている必要があります。環境に https://rube.app/mcp を MCP server として追加できない場合や、Composio/Rube 経由で Formbricks を認可できない場合、この skill は現時点では役に立ちません。

formbricks-automation skill の使い方

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

Claude 互換クライアントで skills を利用できる環境に、Composio skill collection から skill をインストールします。

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

次に、クライアントで https://rube.app/mcp を MCP server として追加し、Rube MCP を設定します。実際の Formbricks 作業を依頼する前に、RUBE_SEARCH_TOOLS が見えていることを確認してください。その後、toolkit formbricks を指定して RUBE_MANAGE_CONNECTIONS を使います。返された status が ACTIVE でない場合は、認可リンクを完了してから再確認します。

使う前に確認すべきファイル

repository path は composio-skills/formbricks-automation で、主に確認すべきファイルは SKILL.md です。短いファイルですが、運用上は重要です。MCP 要件、connection check、必須の search-first pattern、基本シーケンスが定義されています。この skill folder には個別の scripts、rules、references、README files はないため、インストール判断の大部分は、利用中のクライアントが Rube MCP tools を安定して公開できるかどうかにかかっています。

粗い依頼を実用的なプロンプトに変える

弱いプロンプトの例は「Update my Formbricks survey.」です。これでは、どの workspace、survey、fields、安全上の制限を対象にすべきかをエージェントが推測することになります。

より強い formbricks-automation の利用プロンプトは次のようになります。

“Use the formbricks-automation skill. First call RUBE_SEARCH_TOOLS for the exact Formbricks task and current schema. Check that the formbricks connection is ACTIVE. I want to list available surveys, identify the survey named ‘Post-purchase NPS’, and prepare a change plan before modifying anything. Do not execute destructive updates without showing me the tool name, input payload, and expected effect.”

このように書くと、対象オブジェクトを明示し、discovery を依頼し、計画と実行を分け、レビューのゲートを設けられるため、出力品質が上がります。

実務で使いやすいワークフロー

discover、connect、plan、execute の 4 ステップで進めます。まず、汎用的な “Formbricks operations” ではなく、具体的なユースケースに沿って tools を検索するようエージェントに依頼します。次に Formbricks connection を確認します。その後、見つかった tool schema を要約させ、正確な call を提案させます。write operations は、あなたが承認してから実行させるべきです。read-only tasks であっても、失敗時にデバッグしやすくするため、tool slug と主要な inputs を示すよう求めてください。

formbricks-automation skill FAQ

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

いいえ。ただし、接続済み AI tools や認可フローに慣れているユーザーに向いています。管理者が Rube MCP と Formbricks access をすでに設定していれば、非開発者でも利用できます。tool schemas の確認、payloads のレビュー、connection issues の切り分けができるため、開発者や ops teams が最も価値を得やすいでしょう。

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

通常のプロンプトでもやりたいことは説明できますが、現在の Composio Formbricks toolkit schema を自動的に把握できるわけではありません。formbricks-automation skill は、まず tools を検索し、connection state を確認し、返された schema を使うようエージェントに明示します。これにより、存在しない field names の生成を減らし、tool execution をより監査しやすくできます。

この skill を使わないほうがよい場面は？

一般的な Formbricks のアドバイス、survey 文面作成の支援、UI 操作手順だけが必要な場合は使う必要がありません。また、Rube MCP を有効化できない、Formbricks connection を認可できない、MCP tool output を確認せずに保証された挙動が必要、といった場合にも適していません。機密性の高い本番変更では、write または delete action の前に必ず承認ステップを追加してください。

依存するエコシステムは？

この skill は Claude skill support、Rube MCP、Composio の Formbricks toolkit に依存します。upstream skill は toolkit documentation として composio.dev/toolkits/formbricks を示しています。利用可能な tools と schemas は Rube discovery から取得されるため、古いプロンプトの前提よりも、常に最新の RUBE_SEARCH_TOOLS response を信頼してください。

formbricks-automation skill を改善する方法

formbricks-automation の結果をよくする入力の出し方

エージェントには、Formbricks object type、わかっていれば target name または ID、望む結果、安全レベル、変更を read-only にするのか、提案までにするのか、実行まで行うのかを伝えてください。例：“Find responses for survey ID X from the last 30 days and summarize trends; do not modify surveys or contacts.” 権限範囲を明確にすると、エージェントが踏み込みすぎるのを防ぎ、適切な tool query を選びやすくなります。

よくある失敗パターン

よくあるブロッカーは、RUBE_SEARCH_TOOLS が見つからない、Formbricks authorization が inactive、タスク記述が曖昧、schema review を省略している、といったものです。tool call が失敗した場合は、失敗したユースケースで tool discovery をやり直し、試行した payload と返された schema を比較し、どの field または connection state が問題だったのかを説明するようエージェントに依頼してください。

リスクの高い操作にはレビューゲートを追加する

edits、deletions、imports、bulk updates では、2 段階のワークフローを必須にします。まずエージェントが tools を発見し、payload を下書きします。次に、あなたが承認または修正します。これは、survey structure、audience/contact changes、response data workflows のように、技術的には有効な tool call でも運用上は誤りになり得る作業で特に重要です。

最初の出力後に改善を重ねる

最初の結果を受け取ったら、短い execution log を求めてください。含めるべき内容は、discovered tool slug、connection status、使用した inputs、returned result、未解決の assumptions です。これにより、formbricks-automation を一回限りのプロンプトではなく、反復可能な Form Automation workflow として扱えるようになり、次回以降のプロンプトも絞り込みやすくなります。