cardly-automation

cardly-automation skill の概要

cardly-automation でできること

cardly-automation は、Composio の Rube MCP server を通じて Cardly の操作を自動化するための Claude skill です。中核となる価値は、固定化された Cardly ワークフローを実行することではありません。まず現在の Cardly tool schema を検出し、Cardly 接続を確認したうえで、古い API パラメータを推測せずに、稼働中の Rube MCP tools を使ってタスクを実行するようエージェントに指示する点にあります。

Cardly 関連のワークフロー自動化を AI エージェントに任せたい場合で、すでに Rube MCP 経由で実行する前提があるなら、この skill が適しています。

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

cardly-automation skill は、接続済みのツール環境内で Claude に Cardly を操作させたいユーザーに向いています。たとえば、Cardly アクションの準備、利用可能な Cardly 機能の確認、認証後に繰り返し実行する Cardly ワークフローの運用などです。Composio MCP tools を使うエージェントの挙動をチームで標準化したい場合にも特に有効です。ツール検出を必須の最初の手順として組み込めるためです。

一方で、Cardly 戦略の文章化、一般的なグリーティングカード文面の作成、MCP 実行を伴わない手動手順だけが必要な場合には、あまり適していません。

主な差別化ポイント: live schema discovery

最大の特徴は、Cardly タスクを実行する前に RUBE_SEARCH_TOOLS を呼び出すよう明示していることです。これは重要です。MCP tool の名前、フィールド、実行計画は変わる可能性があるためです。一般的なプロンプトでは存在しないパラメータを作り出してしまうことがありますが、この skill は、実行前に現在の tool slug、input schema、既知の注意点を取得するようエージェントを誘導します。

導入前に必要な条件

cardly-automation をインストールまたは利用する前に、利用中の AI クライアントが MCP に対応しており、Rube に接続できることを確認してください。この skill には以下が必要です。

• Rube MCP が server として設定されていること: https://rube.app/mcp
• クライアントで RUBE_SEARCH_TOOLS が利用できること
• RUBE_MANAGE_CONNECTIONS を通じて管理される Cardly 接続
• ワークフロー実行前に接続ステータスが ACTIVE になっていること

cardly-automation skill の使い方

cardly-automation のインストール前後に確認すること

Claude 互換の skill manager が想定する方法で、Composio skills repository から skill をインストールします。一般的なインストール例は次のとおりです。

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

次に、クライアントで https://rube.app/mcp を MCP server として追加し、Rube MCP を設定します。上流の skill では、Rube endpoint に別途 API key は不要とされています。ただし、プロンプトが表示された場合は Cardly toolkit connection の認可が必要です。

インストール後は、まず composio-skills/cardly-automation/SKILL.md を開いてください。この skill フォルダには追加の scripts、rules、resources、README files はありません。そのため、メインファイルが信頼すべき情報源です。

ワークフロー実行前に Cardly を接続する

信頼できる cardly-automation usage の流れは、タスク実行ではなく接続確認から始めます。

1. RUBE_SEARCH_TOOLS が応答することを確認する。
2. toolkit に cardly を指定して RUBE_MANAGE_CONNECTIONS を呼び出す。
3. 返されたステータスが ACTIVE でない場合は、認可リンクに従う。
4. エージェントに Cardly 操作を実行させる前に、接続ステータスを再確認する。

これにより、よくある失敗を避けられます。つまり、エージェントが有効な Cardly ワークフローを設計しても、Cardly アカウントが認証されていないために実行できない、という問題です。

skill が正しく動きやすいプロンプトを書く

弱いプロンプトの例は次のようなものです。

“Use Cardly to do this.”

cardly-automation に適した、より強いプロンプトは次のようになります。

Use the cardly-automation skill for a Cardly workflow. First call RUBE_SEARCH_TOOLS for the exact Cardly task and use the returned schema. Then check the Cardly connection with RUBE_MANAGE_CONNECTIONS. If active, execute the workflow. My goal is: [describe the Cardly task]. Required details: [recipient/customer/card/message/date/budget/constraints]. Ask before executing if any required field is missing.

この形が有効なのは、エージェントに目的、必要な業務コンテキスト、実行権限の境界を与えつつ、live tool discovery を必ず行わせられるためです。

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

多くの cardly-automation for Workflow Automation のケースでは、次の順序で進めます。

1. Discover tools: RUBE_SEARCH_TOOLS を使い、“Cardly operations” のような広い指定ではなく、“create and send a Cardly card” のように具体的なユースケースで検索する。
2. Review returned schemas: 返された schema を確認し、必須フィールドを特定する。
3. Check connection: RUBE_MANAGE_CONNECTIONS で接続を確認する。
4. Fill missing inputs: 不足している入力値は推測せず、ユーザーに確認する。
5. Run the selected Rube tool: schema と接続が確認できた後にのみ、選択した Rube tool を実行する。
6. Summarize results: 使用した tool 名、重要な ID、必要な次のアクションをまとめる。

cardly-automation skill FAQ

cardly-automation は Claude 専用ですか？

この skill は Claude skills format で書かれており、Rube tools が利用できる MCP 対応クライアントを前提にしています。ツールを検出し、接続を検証し、現在の schema に基づいて実行するという考え方自体は他の環境にも応用できますが、インストールと呼び出しの体験は Claude 型の skill 利用向けに設計されています。

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

通常のプロンプトでも、それらしい手順は生成できるかもしれません。しかし、現在の Composio Cardly tool schema を確実に把握することはできません。cardly-automation は、RUBE_SEARCH_TOOLS を呼び出し、利用可能な tool slug とフィールドを確認してから実行する、という実行上の規律を追加します。これにより、存在しないパラメータの生成を減らし、実際の自動化により適した結果にできます。

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

はい。MCP を設定でき、Cardly の認可フローに従える初心者であれば利用できます。skill 自体は短く、指示も明確です。主な学習ポイントは Cardly のコンテンツではありません。エージェントがアクションを実行する前に、Rube MCP tools を検出し、認証を済ませる必要がある、という仕組みを理解することです。

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

Rube MCP にアクセスできない場合、Cardly 接続を認可できない場合、または実行を伴わない助言だけが欲しい場合は、cardly-automation を使うべきではありません。また、現在の Cardly toolkit で公開されていない動作を保証する必要があるワークフローにも不向きです。その場合は composio.dev/toolkits/cardly で toolkit docs を確認するか、Cardly を直接利用してください。

cardly-automation skill の改善方法

cardly-automation の入力情報を改善する

cardly-automation の結果を改善する最も効果的な方法は、実行前にタスクのコンテキストを十分に提供することです。実行したい Cardly アクション、受信者またはアカウントの詳細、メッセージ内容、タイミング、承認要件、制約条件を含めてください。ワークフローが顧客、注文、請求に影響する場合は、tool を実行する前にエージェントへ最終アクションの確認を必ず求めます。

良い入力パターン:

Goal: [specific Cardly task]. Context: [who/what/when]. Required constraints: [brand voice, delivery date, approval step]. Before execution: search Cardly tools, validate connection, list required fields, and ask me about missing values.

よくある失敗パターンに注意する

最も多いミスは、RUBE_SEARCH_TOOLS を省略すること、推測したフィールドを使うこと、Cardly 接続が ACTIVE になる前に実行すること、または必要な Cardly 詳細がない広い目標をそのまま実行可能なものとして扱うことです。最初の出力が汎用的に見える場合は、live schema を使い、不足している必須フィールドを示すようエージェントに指示し直してください。

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

チームでは、上流ファイルの外側に独自の wrapper instructions を追加することで、cardly-automation skill をさらに改善できます。有用なローカルルールには、承認が必要になる金額や条件、許可される Cardly アクション、命名規則、必須の監査サマリー、エージェントが即時実行してよいか、先に計画案を出すべきか、といった項目があります。

リスクの高いワークフローでは、実行前の preflight response として、選択した tool slug、必須入力フィールド、提案値、不足データ、想定される副作用を必ず提示させてください。

初回実行後に改善を重ねる

各実行後には、エージェントに運用面の観点で結果を要約させます。どの Rube tool を使ったか、どの Cardly object または action に影響したか、アクションは成功したか、次に何をすべきかを確認してください。うまくいったプロンプトパターンは、繰り返し使えるよう保存します。これを続けることで、cardly-automation guide の利用は単発の tool calling から、予測しやすいワークフロー自動化プロセスへと発展します。