botstar-automation

botstar-automation skill の概要

botstar-automation でできること

botstar-automation は、Composio の Rube MCP server を通じて Botstar 関連のワークフローを実行するための Claude skill です。固定された Botstar API 仕様を前提にするのではなく、まず現在利用できる Composio Botstar tools を検出し、ユーザーの Botstar 接続を確認したうえで、返されたスキーマに沿ってタスクを実行することを中核の指示にしています。

そのため、botstar-automation skill は、記憶頼みでツール呼び出しを手書きするのではなく、稼働中の Botstar 連携内で AI エージェントに作業させたい場合に特に役立ちます。

向いているユーザーと用途

すでに Botstar を使っていて、利用可能な Botstar アクションの確認、ワークフローステップの準備、Rube MCP 経由でサポートされている Botstar 操作の実行などを Claude に任せたい場合に、この skill が適しています。変わりやすいツールスキーマに対して壊れやすいプロンプト指示を維持したくない、オートメーション構築者、サポートチーム、RevOps 担当者、技術オペレーターに向いています。

この skill の本質的な用途は「Botstar について会話すること」ではありません。Rube MCP に接続し、適切な Botstar tools を見つけ、認可状態を確認し、推測を減らして依頼されたワークフローを実行することです。

主な差別化ポイント: 先にスキーマを検出する

botstar-automation の最大の特徴は、discovery-first の進め方です。上流の skill は、実行前に必ず RUBE_SEARCH_TOOLS を使うよう明示しており、エージェントが現在の tool slugs、入力スキーマ、推奨プラン、注意点を取得できるようになっています。Composio toolkit のスキーマは変わる可能性があるため、これは重要です。汎用的なプロンプトでは、古いパラメータを作り出したり、利用できないツールを呼び出したりするリスクがあります。

導入に必要な前提

この skill は Rube MCP と有効な Botstar 接続に依存します。Claude クライアントが MCP tools を使えない場合や、RUBE_MANAGE_CONNECTIONS で Botstar を認可できない場合、実務上の価値はあまり出ません。リポジトリ内に同梱の補助スクリプトや参照用フォルダはありません。有用な挙動は SKILL.md に集約されています。

botstar-automation skill の使い方

botstar-automation のインストールとセットアップ手順

skill manager を使って、Composio skills repository から skill をインストールします。例:

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

次に、MCP server endpoint を追加して、クライアント側で Rube MCP を設定します。

https://rube.app/mcp

インストール後、MCP tool の RUBE_SEARCH_TOOLS が利用できることを確認します。続いて、toolkit botstar を指定して RUBE_MANAGE_CONNECTIONS を使い、Botstar 接続が有効かを確認します。有効でない場合は、返された認可リンクに従い、ステータスが ACTIVE になってから再試行してください。

skill に渡すべき入力

信頼性の高い botstar-automation usage にするには、達成したい Botstar 上の具体的な結果、分かっている場合は関連するオブジェクト名や ID、制約条件、成功基準をエージェントに渡してください。弱いプロンプトは次のようなものです。

“Automate my Botstar workflow.”

より良いプロンプトは次のようになります。

“Use botstar-automation for Workflow Automation. Check my Botstar connection through Rube MCP, search for the current tools for updating a bot flow, and prepare an execution plan before making changes. The target bot is Support Intake; do not publish changes until I approve the proposed steps.”

この形のほうがうまく機能します。どのタスクのためにツールを探すのか、対象となるエンティティは何か、確認なしに何をしてはいけないのかが明確だからです。

初回実行時の実践的な流れ

まず composio-skills/botstar-automation/SKILL.md を確認してください。この skill フォルダには、追加の README.md、rules/、resources/、scripts/ ファイルはありません。想定される流れは次のとおりです。

1. Claude に botstar-automation を呼び出すよう依頼する。
2. 具体的な Botstar タスクについて RUBE_SEARCH_TOOLS を呼び出させる。
3. toolkit botstar に対して RUBE_MANAGE_CONNECTIONS を呼び出させる。
4. 返された tool schemas とプランを確認する。
5. エージェントが依頼内容を具体的な tool calls に対応付けた後でのみ、実行を許可する。

検出ステップを省略しないでください。この skill は静的な例ではなく、現在のスキーマを調べることを前提に設計されています。

結果をよくするプロンプトの型

botstar-automation guide のように進めたい場合は、次の構成で依頼すると効果的です。

• Goal: Botstar で達成したい結果。
• Scope: 影響を受ける bot、campaign、flow、user segment、resource。
• Permissions: read-only、draft changes、execute のどれか。
• Guardrails: 承認が必要なアクション。
• Output: plan、executed result、audit summary、next-step checklist。

例:

“Run botstar-automation in read-only mode. Discover Botstar tools for listing and inspecting bot flows. Identify which flow handles new lead qualification, summarize available editable fields, and stop before making any update.”

botstar-automation skill FAQ

Rube MCP なしで botstar-automation は使えますか？

いいえ。この skill は RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS に依存するため、Rube MCP が必要です。MCP tool access がなくても、Claude は Botstar について概念的に説明することはできますが、この skill が想定する自動化手順には従えません。

通常の Botstar プロンプトと何が違いますか？

通常のプロンプトでは、Claude が一般知識から Botstar の操作を推測することがあります。botstar-automation は、まず Composio の現在の Botstar toolkit を検索し、接続を確認し、実際のスキーマを使うようエージェントに指示します。これにより、誤ったパラメータ名、利用できない tool calls、認可されていない実行の試行を減らせます。

初心者にも使いやすい skill ですか？

環境がすでに MCP tools に対応している場合に限り、初心者にも扱いやすい skill です。非技術者の場合、https://rube.app/mcp の追加や Botstar の認可でサポートが必要になることがあります。接続が有効になれば、skill は自然言語でワークフローを案内できますが、セットアップ自体は連携設定の作業です。

使わないほうがよいケースは？

botstar-automation は、Botstar 以外のチャットボットプラットフォーム、オフラインの Botstar ドキュメント作成、Botstar 接続を認可できないタスクには使わないでください。また、必要なのがカスタムコード生成だけの場合にも最適ではありません。この skill の価値は、Composio 経由でサポートされている Botstar 操作を実行することにあり、本格的な Botstar SDK プロジェクトを置き換えるものではありません。

botstar-automation skill を改善する方法

botstar-automation のプロンプトはスコープを絞ると改善しやすい

最もよくある失敗は、Botstar の文脈が不足したまま大まかな自動化を依頼することです。正確なワークフロー、対象オブジェクト、リスクレベルを明記すると結果が良くなります。“Find Botstar tools for updating the welcome message in bot X and wait for approval before applying changes” は、“update my bot” よりずっと安全です。

正確な object ID が分からない場合は、まず候補の検出や一覧化を skill に依頼し、その結果から選んでください。

リスクの高い操作には承認ポイントを入れる

この skill は接続済みの tools を通じて動作できるため、明示的な承認ルールを含めてください。たとえば、“Read and plan only”、“Create a draft but do not publish”、“Ask before deleting, overwriting, or triggering user-facing messages.” のように指定します。こうしたガードレールにより、エージェントが調査と実行を切り分けやすくなります。

最初のツール検出後に依頼内容を絞り込む

RUBE_SEARCH_TOOLS が tool schemas を返したら、検出されたツール名、必須フィールド、制限事項を使って依頼を具体化します。強い 2 回目のプロンプトは次のようなものです。

“Using the discovered Botstar tool schema, fill only the required fields for a draft update. If any required value is missing, ask me instead of guessing.”

これにより、ワークフローを実際のツール要件に沿ったものに保てます。

skill を拡張する前にソースを読む

botstar-automation をカスタマイズする予定がある場合は、まず SKILL.md を読んでください。運用パターン全体がそこに含まれています。有用な改善としては、一般的な Botstar タスクの追加例、read-only と write-action の違いが分かりやすいプロンプト、接続が inactive の場合や RUBE_SEARCH_TOOLS が見つからない場合のトラブルシューティングメモなどが考えられます。discovery-first のルールは維持してください。静的な Botstar プロンプトより安全である主な理由がそこにあります。