ko-fi-automation

ko-fi-automation skill の概要

ko-fi-automation でできること

ko-fi-automation は、Composio の Rube MCP server を通じて Ko Fi の操作を自動化するための Claude skill です。価値の中心は、固定された Ko Fi 用スクリプトではありません。実行時に最新の Ko Fi tool schema を見つけ、ユーザーの Ko Fi 接続状態を確認し、選択した Rube tool を実行し、その結果を検証する流れをエージェントに徹底させる点にあります。

これは重要です。MCP tool schema は変更される可能性があるためです。この skill は、記憶にある tool 名や parameters を推測するのではなく、まず RUBE_SEARCH_TOOLS を呼び出すようエージェントに明示します。

ワークフロー自動化ユーザーに向いているケース

ko-fi-automation skill は、すでに Claude で MCP tools を使っていて、Ko Fi 関連タスクをより大きな自動化ワークフローに組み込みたいユーザーに向いています。たとえば、クリエイター運営、サポーター管理、寄付関連のレポート作成、メンバーシップのフォローアップ、Composio 経由で Ko Fi の操作を他システムと連携させるワークフローなどに適しています。

一方で、Ko Fi ページ運営に関する一般的なアドバイスがほしいだけの場合、サポーター向けメッセージを手作業で書きたい場合、または Rube 経由で Ko Fi に接続せずにエクスポート済み CSV ファイルだけを分析したい場合には、あまり効果を発揮しません。

主な差別化ポイントと制約

最大の差別化ポイントは、「まず discovery、次に接続確認、実行、検証」という流れが必須になっていることです。これにより、汎用的な「Ko Fi API を使う」プロンプトよりも安全に運用できます。エージェントが現在有効な schema と実際の接続状態を確認してから動くため、思い込みによる実行を避けやすくなります。

重要な制約は、Rube MCP への依存です。RUBE_SEARCH_TOOLS が利用可能であることに加え、RUBE_MANAGE_CONNECTIONS で ko_fi toolkit を使った有効な Ko Fi 接続が必要です。これらがない場合、skill は手順を計画することはできますが、Ko Fi の操作を実行することはできません。

ko-fi-automation skill の使い方

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

Claude skills 環境に skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill ko-fi-automation

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

https://rube.app/mcp

実際の Ko Fi 作業を依頼する前に、MCP tools が利用できることを確認してください。この skill は RUBE_SEARCH_TOOLS が応答することを前提にしています。続いて、toolkit ko_fi を指定して RUBE_MANAGE_CONNECTIONS を使います。返された status が ACTIVE でない場合は、認証リンクに従って認証し、ワークフローを実行する前に再度チェックしてください。

skill が正しく動くために必要な入力

ko-fi-automation をうまく使うプロンプトには、具体的な Ko Fi タスク、希望する出力形式、安全上の制限、そして計画だけで止めるのか実行まで行うのかを含めるべきです。

弱いプロンプト:

“Automate my Ko Fi.”

より良いプロンプト:

“Use ko-fi-automation to find the current Rube tools for Ko Fi. Check whether my ko_fi connection is active. If active, identify the tool needed to retrieve recent supporter or payment activity for the last 30 days. Show me the discovered schema before executing, then return a concise summary table and any records that require follow-up.”

このプロンプトが有効なのは、対象期間、実行の境界、そして操作前の検証ステップが明確に指定されているからです。

推奨される実行ワークフロー

実用的な ko-fi-automation の進め方は、次の順序に沿うのが基本です。

1. エージェントに、広すぎる一般クエリではなく、対象の Ko Fi タスクに絞って RUBE_SEARCH_TOOLS を呼び出させます。
2. 返された tool slugs、input schemas、execution plans、pitfalls を確認させます。
3. RUBE_MANAGE_CONNECTIONS で Ko Fi 接続を確認します。
4. その後で初めて、選択した Rube tool を schema に合った arguments で実行します。
5. エージェントに response を検証させ、何が変更または取得されたかを要約させ、不確かな fields を明示させます。

すでに実行したい作業が分かっている場合は、“Ko Fi operations” のような広い検索ではなく、“Ko Fi supporter lookup”、“Ko Fi payment activity”、“Ko Fi membership operations” のようなタスク別の discovery query を使うと効果的です。

最初に読むべき repository ファイル

この skill は意図的にコンパクトに作られています。まず composio-skills/ko-fi-automation/SKILL.md を確認してください。提供されている file tree には、追加の README.md、rules/、resources/、references/、helper scripts はありません。つまり、導入の成否は、単一の skill file があなたの環境でエージェントに十分な手順遵守を促せるかに大きく左右されます。

source を確認するときは、prerequisites、setup instructions、tool discovery examples、core workflow pattern に注目してください。これらの section は、運用上の約束事を説明しています。つまり、最初に Rube、次に connection check、その後に live schema、最後に execution という順序です。

ko-fi-automation skill FAQ

ko-fi-automation は通常のプロンプトより優れていますか？

Ko Fi の操作を tool-backed で自動化することが目的なら、はい。通常のプロンプトでは、存在しない API call や古い parameters を作り出してしまうことがあります。ko-fi-automation skill は、エージェントに Rube の現在の Ko Fi tools を検索させ、返された schemas を使わせるため、推測を減らし、信頼性を高められます。

サポーター向けのお知らせ文やキャンペーンコピーの作成など、純粋な編集・ライティング作業だけであれば、ライブの Ko Fi data が必要でない限り、通常のプロンプトで十分な場合もあります。

Composio または Rube MCP は必要ですか？

はい。skill には Rube MCP と、Composio の ko_fi toolkit を通じた有効な Ko Fi 接続が必要です。Claude 環境から MCP tools にアクセスできない場合、この skill で Ko Fi operations を実行することはできません。ワークフローを説明することはできますが、自動化の主なメリットは失われます。

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

MCP server を設定でき、認証リンクに従って接続できる初心者であれば利用できます。ただし、no-code dashboard ではありません。ユーザーは、操作を実行する前に tool schemas を確認するようエージェントへ依頼し、書き込みに近いタスクでは実行前に planned operations を確認できる必要があります。

この skill を使うべきではない場面は？

現在の Rube toolkit で公開されていない、未対応の Ko Fi タスクには ko-fi-automation を使わないでください。また、preview steps、limits、confirmation なしに高リスクな bulk actions を実行する用途も避けるべきです。会計記録として保証された情報が必要な場合は、Ko Fi の公式 dashboard や exports と照合してください。

ko-fi-automation skill を改善する方法

より明確な意図で ko-fi-automation のプロンプトを改善する

ko-fi-automation の結果を改善する最短の方法は、依頼する operation を絞り込むことです。business goal、time range、関係する entities、expected output、permission boundary を含めてください。

例:

“Search Rube for current Ko Fi tools that can retrieve recent donations. Use my active ko_fi connection only after confirming it. Limit the query to the last 7 days if the schema supports dates. Do not send messages or update records. Return donor name, amount, date, message, and follow-up priority.”

これにより、エージェントは安全に tools を選び、意図しない操作を避けるための十分な構造を得られます。

防ぐべきよくある失敗

最もよくある失敗は、RUBE_SEARCH_TOOLS を省略し、tool schema を決め打ちしてしまうことです。これを防ぐには、“search tools first and show the selected schema” と明示してください。もうひとつの典型的な失敗は、Ko Fi 接続が ACTIVE になる前に実行しようとすることです。connection check を独立したステップとして必ず要求してください。

3つ目の失敗は、scope が曖昧なことです。“Handle supporters” には、読み取り、メッセージ送信、タグ付け、エクスポート、要約など、複数の意味があり得ます。曖昧な動詞は、retrieve、list、summarize、draft、update、confirm のように観測可能な action に置き換えてください。

初回出力の後に反復する

最初の実行後は、実際の tool response と依頼した fields を比較するようエージェントに依頼します。fields が不足している場合は、その制限が schema、permissions、connection state、prompt のどれに由来するのかを説明させてください。そのうえで task を調整し、必要に応じて discovery を再実行します。

定期的に使うワークフローでは、好みの date ranges、review gates、output columns を含めた最適な prompt pattern を保存しておくと便利です。ko-fi-automation skill は、単発の広い依頼よりも、繰り返し使える運用指示と組み合わせたときに最も価値を発揮します。