agencyzoom-automation

agencyzoom-automation skill の概要

agencyzoom-automation の用途

agencyzoom-automation は、Composio の Rube MCP server 経由で Agencyzoom CRM の操作を実行するための Claude skill です。価値の中心は、固定されたハードコード済みアクションの一覧ではありません。まず現在の Agencyzoom tool schema を検出し、接続を確認したうえで、依頼されたワークフローに適した Rube MCP tool を実行するようエージェントに教える点にあります。

CRM レコード操作、pipeline 更新、アカウントのフォローアップ業務、運用チェックなど、利用できる正確なアクションが稼働中の Composio toolkit schema に依存する Agencyzoom タスクを AI アシスタントに支援させたい場合に、この skill が役立ちます。

CRM Operations チームに最適

agencyzoom-automation skill は、すでに Agencyzoom を利用していて、認証済みの MCP 接続を通じて Claude に操作させたい CRM Operations、代理店管理者、RevOps、オートメーション担当者に特に向いています。記憶ベースで API フィールドを推測するのではなく、最新の tool discovery が必要なタスクでとくに有用です。

一方で、Agencyzoom についての文章による助言だけが必要な場合、Rube MCP を利用できない場合、または有効な Agencyzoom 接続を認可できない場合には、あまり適していません。

主な差別化ポイント: 実行前にツールを検索する

中核となるパターンは、「Agencyzoom schema を決め打ちしない」ことです。この skill は、実行前に RUBE_SEARCH_TOOLS を呼び出すようエージェントに指示します。これにより、現在の toolkit version で利用可能な tool slug、必須入力、フィールド名、推奨プラン、注意点を取得できます。

これは重要です。CRM 自動化では、エージェントがフィールド名を作り出したり、古い schema を使ったり、認証が完了する前に実行しようとしたりすると、すぐに失敗につながるためです。

インストール前に確認すべきこと

上流の skill はコンパクトで、現時点では主に 1 つのファイル SKILL.md を中心に構成されています。skill フォルダ内に追加のスクリプト、リソース、ルール、README ファイルはないため、インストール判断のポイントは、主に Rube MCP と Agencyzoom を利用しているかどうかです。

まず SKILL.md を読み、必要な MCP server、接続ワークフロー、tool discovery のパターンが自社環境に合うか確認してください。

agencyzoom-automation skill の使い方

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

利用しているクライアントが GitHub からの skill インストールに対応している場合は、たとえば次のように Composio skill collection から skill をインストールします。

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

次に、AI クライアントに以下を追加して Rube MCP を設定します。

https://rube.app/mcp

この skill は Rube MCP tools が利用可能であることを前提にしており、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS が必要です。実務で使う前に、RUBE_SEARCH_TOOLS が応答すること、Agencyzoom toolkit connection が ACTIVE であることをエージェントに確認させてください。

必要な接続と discovery フロー

実用的な agencyzoom-automation の利用フローは、次のように進めるのがよいでしょう。

1. Rube MCP が接続されていることを確認する。
2. toolkit agencyzoom で RUBE_MANAGE_CONNECTIONS を使用する。
3. 接続が active でない場合は、返された認証リンクから認証を完了する。
4. 対象の Agencyzoom ジョブについて RUBE_SEARCH_TOOLS を呼び出す。
5. 検出された tool schema と必須フィールドを確認する。
6. tool と入力内容が確認できてから実行する。

最初の指示としては、次のような内容が適しています。

Use the agencyzoom-automation skill. First verify Rube MCP access, then check that the Agencyzoom connection is active. Search for the current tool schema for updating Agencyzoom CRM records before taking any action.

粗い目的を実行可能なプロンプトにする

弱いプロンプト:

Update my Agencyzoom leads.

よりよいプロンプト:

Use agencyzoom-automation for CRM Operations. I need to update Agencyzoom lead records that match these criteria: [criteria]. First call RUBE_SEARCH_TOOLS for the exact Agencyzoom operation and show me the discovered tool name, required fields, and any missing inputs. Do not execute until I confirm the mapping. When ready, update only the records in this list: [record IDs or exported table].

後者のプロンプトの方が有効なのは、タスクの範囲を明示し、schema discovery を求め、確認ステップを必須にし、承認前に広範な CRM 変更が行われるのを防げるからです。

最初に読むべきファイルとソースパス

まず以下を確認してください。

• composio-skills/agencyzoom-automation/SKILL.md

このファイルには、前提条件、セットアップ、tool discovery、基本的なワークフローパターンという運用上の取り決めが含まれています。この skill には補助スクリプトや参照用フォルダがないため、自社代理店向けの事前構築済みビジネスロジックが用意されているとは考えないでください。ワークフロールール、レコード条件、承認ステップ、データマッピングは、プロンプト側で指定する必要があります。

agencyzoom-automation skill FAQ

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

いいえ。この skill には Rube MCP が必要です。RUBE_SEARCH_TOOLS が利用できない場合、エージェントはこの skill の主要な安全パターンに従えません。また、エージェントが認証済み操作を実行するには、RUBE_MANAGE_CONNECTIONS を通じた有効な Agencyzoom 接続も必要です。

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

通常のプロンプトでも Claude に「Agencyzoom を使って」と依頼することはできますが、live tool discovery は強制されません。agencyzoom-automation skill の価値は、アクションを選ぶ前に現在の Composio tool schema を検索するようエージェントに指示する点にあります。これにより schema の幻覚を減らし、利用可能な Agencyzoom tools の変更にもエージェントが対応しやすくなります。

初心者でもこの skill を使えますか？

はい。MCP を設定し、Agencyzoom の認可フローを完了できるなら利用できます。初心者は、読み取り専用または低リスクの確認から始め、実行前に検出された tool schema をエージェントに表示させ、CRM データを変更する前には承認を必須にするのがよいでしょう。

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

テスト済みのレコード一覧、承認ステップ、ロールバック計画がない状態での一括 CRM 変更には使わないでください。また、主な目的が戦略的な助言、研修コンテンツ、ドキュメント作成である場合も避けるべきです。この skill は Composio 経由で live Agencyzoom operations を行うためのものであり、一般的な CRM コンサルティング向けではありません。

agencyzoom-automation skill の改善方法

制約を加えて agencyzoom-automation プロンプトを改善する

出力品質を最も大きく改善する方法は、エージェントに明確な運用制約を与えることです。以下を含めてください。

• 影響を与えたい Agencyzoom object または workflow
• Record IDs、検索条件、または source table
• 読み取りまたは更新するフィールド
• 書き込む値と、空欄の扱い
• エージェントが実行してよいのか、承認を待つ必要があるのか
• 除外する records、statuses、pipelines

これにより、agencyzoom-automation が広い前提で判断するのではなく、意図した CRM 操作に集中できます。

実行前に失敗パターンを減らす

よくある失敗パターンには、接続が inactive、フィールド名に関する古い思い込み、必須フィールドの不足、更新条件が広すぎることなどがあります。実行 tool を呼び出す前に、検出された RUBE_SEARCH_TOOLS の結果サマリーをエージェントに表示させることで防げます。

安全性を高める指示としては、次のようなものが有効です。

If the current Agencyzoom schema does not expose the required operation, stop and explain the gap. Do not substitute a different CRM action without approval.

最初の tool result の後に反復する

最初の discovery または execution result の後は、意図したワークフローと実際に起きたことを照合するようエージェントに依頼してください。有用なフォローアップには次のようなものがあります。

• “Which required fields are still missing?”
• “Which records were skipped and why?”
• “Show the exact mapping before the next update.”
• “Run a smaller batch first.”
• “Summarize the completed changes for audit notes.”

CRM Operations チームにとっては、誤った更新のコストが追加の確認ステップのコストより高いため、このような反復は特に重要です。

チーム固有の運用ルールを追加する

上流の skill には、代理店固有のポリシーは含まれていません。agencyzoom-automation の信頼性を高めるには、プロンプトまたはローカルの skill notes に、自社のルールを追加してください。たとえば、承認しきい値、命名規則、許可された pipelines、除外 statuses、audit-log format、batch-size limits などです。

継続的に利用する場合は、よくある Agencyzoom タスクと、承認済みプロンプト、必須レビュー checkpoint を対応づけた短い社内 playbook を維持するとよいでしょう。