givebutter-automation

givebutter-automation skill の概要

givebutter-automation の用途

givebutter-automation skill は、Composio の Rube MCP インターフェースを通じて、AI エージェントが Givebutter の作業を自動化できるようにするためのスキルです。エージェントが現在の Givebutter ツールスキーマを確認し、認証済みの接続を検証したうえで、記憶に頼って API フィールドを推測するのではなく、適切な Rube ツール呼び出しで操作するワークフローに向いています。

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

このスキルは、すでに Givebutter を利用していて、Claude やその他の MCP 対応エージェントに運用作業を手伝わせたい非営利団体の運営担当者、キャンペーンチーム、ファンドレイジング管理者、自動化を構築する人に適しています。典型的な用途は、支援者、キャンペーン、取引、連絡先、イベント、レポート関連のワークフローです。利用可能な正確なアクションは、RUBE_SEARCH_TOOLS を通じて実行時に確認する前提です。

一般的なプロンプトとの違い

通常のプロンプトでは、エージェントに「Givebutter を更新して」「寄付者データを取得して」と頼むことはできますが、スキーマの確認や接続検証までは強制できません。givebutter-automation skill は、より安全な実行パターンを追加します。まずツールを検索し、Givebutter 接続を確認し、返されたスキーマを使い、Rube MCP 経由で実行し、結果を検証する流れです。Composio のツール名、フィールド、対応操作は変わる可能性があるため、この手順が重要です。

導入時の主な制約

このスキルは Rube MCP と有効な Givebutter 接続に依存します。単体で動く Givebutter API ラッパーではなく、補助スクリプト、ローカルリソース、独立した README も含まれていません。インストール前に、利用する AI クライアントが MCP サーバーに対応しており、https://rube.app/mcp にアクセスできることを確認してください。

givebutter-automation skill の使い方

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

クライアントがスキルのインストールに対応している場合は、Composio skills リポジトリからスキルをインストールします。

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

次に、クライアント設定に Rube MCP を MCP サーバーとして追加します。

https://rube.app/mcp

リポジトリ内の SKILL.md には、このパッケージ専用のランタイムやスクリプトは用意されていません。重要なのは、MCP が利用できることと、Rube を通じて管理される Givebutter 接続があることです。

タスク実行前に必要な設定

まず RUBE_SEARCH_TOOLS が利用可能か確認します。次に、toolkit givebutter を指定して RUBE_MANAGE_CONNECTIONS を使い、接続が有効かどうかを確認します。Rube が認証リンクを返した場合は、エージェントに Givebutter データの変更や取得を依頼する前に、認証フローを完了してください。

最初の実用的なプロンプト例は次のとおりです。

Use the givebutter-automation skill. First call RUBE_SEARCH_TOOLS for my Givebutter task, then check the givebutter connection with RUBE_MANAGE_CONNECTIONS. Do not execute changes until you show me the discovered tool, required fields, and planned action.

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

弱いプロンプト:

Update my Givebutter donors.

より良いプロンプト:

Use givebutter-automation for Workflow Automation. I need to find Givebutter supporters who donated to campaign [campaign name or ID] between [date range], identify records missing phone numbers, and prepare an update plan. First discover current Givebutter tools with RUBE_SEARCH_TOOLS; then confirm the Givebutter connection is active. If a write operation is needed, show the exact fields you will send before executing.

このスキルは検出されたスキーマに基づいて動くため、入力が具体的なほど出力の精度が上がります。オブジェクト種別、キャンペーンまたはイベントの識別子、日付範囲、希望する読み取り／書き込み操作、照合ルール、変更前にエージェントを一時停止させるかどうかを含めてください。

最初に確認すべきファイルとソースパス

重要なソースファイルは次のとおりです。

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

前提条件、セットアップ、ツール検出、接続確認、実行、結果検証という必須ワークフローを確認するために、このファイルを読んでください。同梱スクリプト、参照ファイル、ルール用フォルダはないため、実装上の詳細の多くは Rube のライブツール検出と Composio の Givebutter toolkit ドキュメントから得ることになります。

givebutter-automation skill の FAQ

givebutter-automation は初心者にも使いやすいですか？

MCP 対応の AI クライアントをすでに使えて、Rube 経由で Givebutter を認証できるなら、初心者にも扱いやすいスキルです。一方で、クリック操作だけで完結する連携を期待している場合はやや不向きです。エージェントが MCP ツールを呼び出し、返されたスキーマを解釈する必要があります。初心者は、更新を許可する前に、読み取り専用の検出タスクやレポート作成タスクから始めるのがおすすめです。

Givebutter ダッシュボードの代わりになりますか？

いいえ。givebutter-automation skill は、繰り返し発生する運用ワークフロー、一括支援、レポート準備、ガイド付きの更新に向いています。手動レビュー、視覚的なキャンペーン管理、人が直接レコードを確認すべき慎重な単発変更には、引き続き Givebutter ダッシュボードのほうが適しています。

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

Rube MCP に接続できない場合、Givebutter アカウントが認証されていない場合、またはツール検出前に特定の Givebutter 操作が必ず使えることを保証したい場合は、このスキルを使うべきではありません。また、支援者、支払い、キャンペーン、イベントのデータに対する監視なしの書き込み操作も避けてください。書き込みを行う場合は、プロンプトに承認ゲートと検証手順を含める必要があります。

なぜ最初にツール検索が必要なのですか？

上流のスキルでは、ワークフローの前に RUBE_SEARCH_TOOLS を使うことが明示的に求められています。現在のツール slug、入力スキーマ、推奨される実行計画、注意点が動的に返されるためです。検出を省略すると、不正なフィールド、誤った前提、失敗する自動化のリスクが高まります。

givebutter-automation skill を改善する方法

givebutter-automation の結果を良くするプロンプト改善

givebutter-automation をより効果的に使うには、最終目標だけでなく、運用上の境界条件もエージェントに伝えてください。タスクが読み取り専用なのかデータ書き込みを許可するのか、何を一致とみなすのか、重複をどう扱うのか、変更をバッチ処理するのか、どの時点で承認待ちにするのかを指定します。

例:

Find supporters from campaign Spring Gala 2025 with donations over $250. Return a table with name, email, donation total, and missing fields. Do not update records. If an update tool exists, only describe the schema and ask before using it.

書き込みワークフローに安全策を追加する

更新を行う場合は、検出、計画、実行、検証を分けるようエージェントに指示してください。強いワークフローは、ツールを検出する、接続を確認する、対象レコードを取得する、変更案を要約する、承認を待つ、小さなバッチで実行する、成功と失敗を報告する、という流れです。これにより、支援者データやキャンペーンデータを誤って編集するリスクを下げられます。

よくある失敗パターン

最も多い問題は、Givebutter 認証が無効であること、ツール検出を省略すること、オブジェクト識別子が曖昧なこと、未対応の操作を要求するプロンプトです。最初の結果が失敗した場合は、エージェントに、使用した正確な Rube ツールスキーマ、不足していた必須フィールド、次に取り得る最も安全な代替案を提示させてください。

初回出力後に改善していく

初回実行後は、返されたスキーマ名とフィールド要件を使ってタスクを絞り込みます。たとえば、「get recent donors」ではなく、「use the discovered donor or transaction search tool for donations after 2025-01-01, filtered by campaign ID」のように具体化します。このように反復することで、givebutter-automation skill は幅広いアシスタントから、信頼性の高い Givebutter ワークフロー運用担当へと近づきます。