retently-automation

retently-automation skill の概要

retently-automation ができること

retently-automation は、Composio の Rube MCP server 経由で Retently の作業を自動化するための Claude skill です。適切な Retently tool の検索、Retently 接続状態の確認、そして RUBE_SEARCH_TOOLS で現在の tool schema を把握してから操作を実行する、といったタスクを想定しています。

向いているユーザーとワークフロー

この skill は、すでに Retently を顧客体験、NPS、アンケート、フィードバックのワークフローで使っていて、コピー＆ペーストされた API 前提に頼るのではなく、MCP tool レイヤーを通じて AI agent に Retently を操作させたいチームに向いています。特に retently-automation for Workflow Automation を探しているユーザーに適しています。実行前に再現性のある tool discovery を行う点が、この skill の中心だからです。

主な差別化ポイント: schema-first execution

導入時に重視すべき点は、この skill が「Retently を知っている」ことではありません。最大の価値は、agent に対してまず Rube tools を検索し、実際の schema を確認し、Retently 接続を検証したうえで、該当する tool を実行するよう促すことです。これにより、古い tool 名、変更された parameters、不十分な prompt による失敗を減らせます。

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

リポジトリ内の主なファイルは composio-skills/retently-automation/SKILL.md の 1 つです。まずこのファイルを読んでください。 bundled scripts、examples、rules、reference folders は含まれていないため、導入判断は Rube MCP への依存と Retently connection model が自分の環境に合うかどうかを基準にするのがよいでしょう。

retently-automation skill の使い方

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

retently-automation skill を使うには、利用している AI client が skills と MCP servers に対応している必要があります。この skill 自体は Rube MCP を必要とし、mcp: [rube] を宣言しています。実際のインストールは大きく 2 段階です。

1. ComposioHQ/awesome-claude-skills から skill を追加またはインストールします。path は composio-skills/retently-automation です。
2. client configuration に Rube MCP を server として追加します。URL は https://rube.app/mcp です。

その後、MCP tools が表示されていることを確認します。この skill は RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS を呼び出せることを前提にしています。Retently toolkit connection が active になるまで、retently-automation install は完了していません。

skill に渡すべき入力

「Retently を更新して」のような曖昧な依頼では、不確定要素が多すぎます。agent には、業務オブジェクト、実行したい action、filters、安全上の制限、期待する出力を伝えてください。より有効な入力には次のようなものがあります。

• Retently task: create、find、update、list、trigger、sync、audit。
• 対象範囲: campaign、survey、contact、company、response、audience、segment など、分かっているもの。
• identifiers または filters: emails、account IDs、date ranges、campaign names、tags、status。
• constraints: まず dry run、結果件数を制限、確認なしに records を変更しない。
• desired output: summary table、changed-record list、errors、next-step recommendations。

prompt の例:

Use retently-automation to find the current Rube tools for Retently, confirm the Retently connection is active, then list recent survey responses from the last 14 days. Do not modify anything. Return the tool selected, schema fields used, result count, and any records missing customer email.

実務での retently-automation 利用フロー

信頼性の高い retently-automation usage フローは次の通りです。

1. 正確な Retently use case に対して RUBE_SEARCH_TOOLS を呼び出すよう agent に依頼します。
2. 返された tool slug と必須 schema fields を確認します。
3. connection state が不明な場合は、toolkit retently に対して RUBE_MANAGE_CONNECTIONS を使います。
4. connection が ACTIVE でなければ、返された authorization flow を完了します。
5. 書き込み操作の前に read-only queries を実行します。
6. 書き込みでは、preview plan を出させ、実行前の確認を必須にします。

これは重要です。skill の source 自体が、現在の schemas をまず発見する必要があると明示しているためです。Retently parameters を記憶から推測するよう agent に促してはいけません。

最初に読むべきファイル

まず SKILL.md から確認してください。特に次の sections に注目します。

• Prerequisites: MCP と Retently connection の要件。
• Setup: connection activation。
• Tool Discovery: 必須となる RUBE_SEARCH_TOOLS pattern。
• Core Workflow Pattern: discovery、connection check、execution の順序。

skill folder には helper scripts や sample workflows がないため、field-level behavior を詳しく確認したい場合は、upstream の Composio Retently toolkit documentation を参照してください。

retently-automation skill FAQ

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

いいえ。この skill は Rube MCP を前提に設計されています。client が RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS を呼び出せない場合、この skill の中核となる実行経路は使えません。workflow note として読むことはできますが、本来の意図どおりには機能しません。

通常の Retently prompt より何が優れていますか？

通常の prompt では、model が一般知識から Retently operations を推測することがあります。retently-automation skill は、より安全な pattern を強制します。利用可能な tools を発見し、live schemas を確認し、connection state をチェックしたうえで、ようやく実行します。古い前提が failed calls や意図しない変更につながりうる運用ワークフローでは、この方が信頼性が高くなります。

初心者にも向いていますか？

はい。ただし、MCP-capable client にアクセスでき、Retently authorization step を完了できることが前提です。これは Retently の包括的なチュートリアルではありません。新しいユーザーは、更新作業に入る前に、campaigns の一覧表示、connection status の確認、recent responses の取得といった read-only tasks から始めるのが安全です。

この skill を使わない方がよいケースは？

直接的な Retently API code、offline analysis、custom ETL scripts、Composio/Rube の外にある workflows が必要な場合は使わないでください。また、高リスクな bulk updates にも注意が必要です。正確な filters を指定でき、dry run を必須にし、実行前に proposed tool call を確認できる場合を除き、避けるべきです。

retently-automation skill を改善する方法

具体的な scope で retently-automation prompts を改善する

retently-automation の結果を改善する最短の方法は、広すぎる目標を運用上の constraints に置き換えることです。たとえば、次のように依頼するのではなく:

Sync Retently contacts.

次のように依頼します。

Use retently-automation to discover the current Retently contact tools, verify the active connection, then prepare a dry-run plan to update contacts with tag enterprise-qbr where last_survey_sent is empty. Show required schema fields and wait for approval before writing.

これにより、agent は tools を選びやすくなり、危険な書き込みを避け、計画を説明するための十分な context を得られます。

防ぐべきよくある失敗

よくある失敗は、tool discovery の省略、inactive な Retently connection、identifiers の不足、確認なしの write operations です。prompt に次の指示を加えることで防ぎやすくなります。

• “Call RUBE_SEARCH_TOOLS first.”
• “Check RUBE_MANAGE_CONNECTIONS for toolkit retently.”
• “Use read-only lookup before any mutation.”
• “If required fields are missing, ask me instead of guessing.”
• “For bulk changes, return a preview and wait.”

最初の出力後に反復する

最初の response を受け取ったら、agent が selected tool slug、required fields、connection state、execution result を報告しているか確認します。どれかが欠けている場合は、次のように再確認を依頼します。

Re-run the planning step. Include the discovered Retently tool slug, required input schema, optional filters, connection status, and the exact fields you still need from me.

これにより、この skill を一度きりの自動化依頼ではなく、管理された workflow として使えるようになります。

skill をさらに強くするには

現在の skill は簡潔で実務向きですが、example prompts、read-only と write-operation の patterns、一般的な Retently use cases、failure-handling guidance があると、より導入しやすくなります。survey responses の一覧取得、campaigns の確認、contacts の安全な更新といった小さな例を追加すれば、schema-first design を変えずに install confidence を高められます。