simple-analytics-automation
作者 ComposioHQsimple-analytics-automation 可協助代理透過 Composio Rube MCP 自動化 Simple Analytics：先驗證 simple_analytics 連線、使用 RUBE_SEARCH_TOOLS 探索目前的工具 schema，並安全執行工作流程自動化任務。
此技能評分為 66/100，表示可納入目錄，但應定位為輕量的 MCP 工作流程指南，而不是完整的自動化套件。它提供代理足夠的觸發與設定指引，可透過 Rube MCP 操作 Simple Analytics；不過目錄使用者應預期需要依賴即時工具探索，因為 repository 證據未包含具體的端到端 Simple Analytics 任務範例或支援檔案。
- 有效的 frontmatter 清楚標示技能名稱，並聲明 Simple Analytics 自動化需要 Rube MCP。
- 先決條件與設定步驟說明如何驗證 Rube MCP、管理 Simple Analytics 連線，並在使用前確認連線為 ACTIVE。
- 此技能反覆要求代理先呼叫 RUBE_SEARCH_TOOLS，可在 Composio 工具定義變更時降低猜測 schema 的風險。
- 除了 SKILL.md 之外，沒有支援檔案、腳本、參考資料或內建範例，因此所有執行都仰賴即時的 Rube MCP 探索結果。
- 目前可見的內容多半是通用的探索與設定流程，沒有展示具體的 Simple Analytics 工作流程，也沒有列出常見任務所需的參數。
simple-analytics-automation skill 概覽
simple-analytics-automation 的功能
simple-analytics-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP server 自動化 Simple Analytics 相關工作。它的主要價值不在於提供一組寫死的分析指令，而是教代理程式先探索目前可用的 Simple Analytics tool schemas、確認連線狀態，再針對指定的分析流程執行正確的 Rube tool。
最適合 Workflow Automation 使用者
這個 simple-analytics-automation skill 最適合已經在使用 Simple Analytics，並希望透過代理程式輔助執行可重複報表、資料查詢或帳號操作的團隊，而不必手動處理每個 API 細節。它特別適合 Workflow Automation 情境，因為實際 tool inputs 可能會隨時間改變；此 skill 要求在執行前先使用 RUBE_SEARCH_TOOLS，而不是依賴過時的假設。
採用前的關鍵需求
關鍵相依項目是 Rube MCP。你的 AI client 必須設定 Rube MCP server：https://rube.app/mcp，並且 Simple Analytics toolkit connection 必須透過 RUBE_MANAGE_CONNECTIONS 啟用，toolkit 為 simple_analytics。如果 Rube MCP 無法使用，或 Simple Analytics connection 尚未完成驗證，這個 skill 除了作為設定檢查清單之外，實際用途會很有限。
與一般 prompt 的差異
一般 prompt 可能只是要求助理「取得 Simple Analytics data」，然後期待它知道 API 該怎麼用。這個 skill 則加入更安全的操作模式：搜尋可用的 Rube tools、檢查目前 schemas、確認驗證狀態，接著執行合適的 Simple Analytics operation。這能降低因 tool names 過期、欄位缺漏或參數猜測而造成的失敗。
如何使用 simple-analytics-automation skill
simple-analytics-automation 安裝情境
如果你的環境支援從這個 repository 安裝 skills，請使用：
npx skills add ComposioHQ/awesome-claude-skills --skill simple-analytics-automation
接著在你的 AI client 中加入 Rube MCP：
https://rube.app/mcp
上游 skill 本身預期可使用 Rube MCP tools，特別是 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。安裝後，請先開啟 composio-skills/simple-analytics-automation/SKILL.md；目前 repository tree 中沒有額外的 scripts/、resources/ 或 references/ 資料夾，因此該 skill file 是主要的操作說明來源。
執行工作流程前需要提供的輸入
在要求代理程式執行 Simple Analytics 任務前，請提供：
- 明確的 Simple Analytics 目標，例如「retrieve traffic metrics for a site」、「check available analytics operations」或「prepare a recurring report」。
- 相關的 site、domain、date range、filters 或 metric names。
- 任務是只需要探索 tools、驗證存取權，還是要實際執行 operation。
- 任何輸出格式需求，例如表格、可轉成 CSV 的摘要、JSON，或簡短的主管摘要。
這個 skill 最重要的規則是先搜尋。好的 prompt 應該明確允許代理程式呼叫 RUBE_SEARCH_TOOLS 取得目前 schema，而不是自行猜測欄位。
適合使用的 prompt 寫法
較弱的 prompt 是：
“Use Simple Analytics to get my stats.”
更好的 simple-analytics-automation 使用 prompt 是：
“Use the simple-analytics-automation skill. First verify Rube MCP is available and check the simple_analytics connection status. Then call RUBE_SEARCH_TOOLS for the current Simple Analytics tool schema for retrieving website traffic metrics. If the connection is active, fetch metrics for example.com for the last 30 days. Return a concise table with visitors, pageviews, top pages if available, and mention any fields or metrics that the discovered schema does not support.”
這樣比較有效，因為它定義了連線檢查、探索步驟、目標 domain、時間範圍、需要的 metrics，以及輸出格式。
建議遵循的實務流程
請使用三階段工作流程：
- 連線階段：確認 Rube MCP 有回應，並透過
RUBE_MANAGE_CONNECTIONS確認 Simple Analytics 狀態為 ACTIVE。 - 探索階段：針對具體使用情境執行
RUBE_SEARCH_TOOLS，不要使用模糊查詢。例如：“Simple Analytics traffic summary by domain and date range.” - 執行階段：嚴格依照回傳的 tool slug 和 schema 使用，然後在摘要中說明任何限制。
不要因為前一次執行成功就跳過探索。這個 skill 的設計假設是：目前的 Rube schemas 才是可信來源。
simple-analytics-automation skill 常見問題
simple-analytics-automation 只適合開發者嗎？
不是。只要 AI client 支援 MCP tools，且有人已連接 Rube MCP，非開發者也可以使用。不過，設定上會比一般聊天 prompt 更技術一些，因為它依賴 MCP configuration 和 Simple Analytics authentication。
什麼時候不該使用這個 skill？
如果你需要離線分析、不透過 Composio/Rube 直接存取 Simple Analytics API，或建立完全客製化的 analytics pipeline，就不適合使用它。simple-analytics-automation skill 是圍繞 Rube MCP tool execution 設計的；如果你的環境無法將 MCP tools 暴露給代理程式使用，就不是理想選擇。
它會取代 Simple Analytics dashboards 嗎？
不會。它是用來補強 dashboard，協助自動化特定查詢、摘要與可重複的報表流程。若是探索式的視覺分析，Simple Analytics 介面可能仍然更快。若是排程、代理程式驅動，或多步驟的 Workflow Automation 任務，這個 skill 會更實用。
為什麼這個 skill 堅持要先做 tool discovery？
因為 Composio toolkit schemas、tool slugs 和必填欄位都可能變動。RUBE_SEARCH_TOOLS 會回傳目前的 tool names、input schemas、execution plans 和 pitfalls。這是 simple-analytics-automation guide 中最重要的可靠性機制，也是疑難排解時第一個要確認的項目。
如何改進 simple-analytics-automation skill
改進 simple-analytics-automation prompts
最快的改進方式，是把任務描述得更清楚。請包含 analytics object、time range、domain、metrics、output format，以及是否允許執行。例如：
“Discover the current Simple Analytics tools for listing top referrers for example.com over the previous calendar month. If supported, run the operation and return top referrers with counts. If not supported, report the closest available tool and the missing field.”
這會給代理程式清楚的成功條件，以及安全的 fallback。
常見失敗模式與預防方式
最常見的失敗包括跳過 schema discovery、Simple Analytics connection 未啟用、metric 要求過於模糊，以及自行假設 field names。請要求代理程式做到以下幾點來避免：
- 確認
RUBE_SEARCH_TOOLS可用。 - 執行前檢查
simple_analyticsconnection status。 - 嚴格使用探索到的 schema。
- 在呼叫 execution tools 前，先詢問缺少的 domain、date range 或 metric details。
這些檢查比華麗的 prompt wording 更重要。
依據第一次結果持續迭代
取得第一次輸出後，請根據探索到的 tools 實際支援內容進行調整。如果結果缺少你預期的 metric，請要求代理程式針對更精準的使用情境再搜尋一次，例如使用 “Simple Analytics top pages by date range”，而不是 “analytics report”。如果 schema 提供 pagination、filters 或 grouping options，請用第二輪流程提升完整度，不要直接接受第一次摘要。
給維護者的 repository 閱讀路徑
若維護者要評估或擴充 simple-analytics-automation skill，請從 SKILL.md 開始。重點檢視 prerequisite block、setup sequence、tool discovery instruction，以及核心 workflow pattern。由於目前這個 skill 沒有 companion scripts 或 reference files，後續改進應優先加入具體 example prompts、connection 未啟用時的 troubleshooting branches，以及 traffic summaries、referrer checks、recurring report generation 等 sample task categories。