geokeo-automation

geokeo-automation skill 概览

geokeo-automation 能做什么

geokeo-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行与 Geokeo 相关的工作流。它的核心价值不在于提供一段固定脚本，而是为 agent 提供一种更安全的操作模式：先发现当前可用的 Geokeo tool schema，检查用户的 Geokeo 连接状态，再根据请求执行合适的 Rube MCP tools。

这一点很重要，因为 Rube 的 tool 名称、schema 和执行建议都可能变化。该 skill 的核心指令是先调用 RUBE_SEARCH_TOOLS，再基于返回的 schema 行动，而不是凭记忆猜测参数。

最适合 Workflow Automation 用户

geokeo-automation skill 最适合已经在使用，或计划在 agentic workflow automation 中使用 Geokeo 的用户。它适用于需要 assistant 通过 Composio 操作 Geokeo 的任务，而不只是让 assistant 用文字解释 Geokeo。

适合的用户包括：

• 将 Claude 或其他支持 MCP 的客户端连接到 SaaS 工作流的团队
• 希望 agent 通过 Rube MCP 发现并运行 Geokeo tools 的运营人员
• 在把 Geokeo automation flows 嵌入更大工作流前进行验证的开发者
• 能完成 OAuth 风格连接流程、但希望 assistant 负责 tool discovery 的非开发者

采用前的关键要求

在安装或调用 geokeo-automation 之前，请确认你的客户端可以使用 MCP tools，并且 Rube MCP 可用。上游 skill 声明依赖 rube MCP server，并明确要求：

• RUBE_SEARCH_TOOLS 可用
• RUBE_MANAGE_CONNECTIONS 可用
• geokeo toolkit 下存在 active Geokeo connection
• 执行前先进行 tool discovery

如果你无法添加 MCP servers，或无法授权外部连接，这个 skill 就不会有实际帮助。它不是一个独立的 Geokeo API wrapper，也不包含本地脚本、打包参考资料或 fallback code。

如何使用 geokeo-automation skill

geokeo-automation 的安装与设置路径

请从你的 skills manager 使用的 repository path 安装该 skill。对于 Claude Skills 风格的安装，预期来源是：

ComposioHQ/awesome-claude-skills → composio-skills/geokeo-automation

常见安装形式为：

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

然后在客户端中添加以下地址来配置 Rube MCP：

https://rube.app/mcp

MCP 连接完成后，验证所需 tools 是否可见。实际设置流程建议如下：

1. 确认 RUBE_SEARCH_TOOLS 有响应。
2. 使用 toolkit geokeo 调用 RUBE_MANAGE_CONNECTIONS。
3. 如果连接状态不是 ACTIVE，按照返回的授权链接完成授权。
4. 在要求 agent 执行任何 Geokeo 操作之前，再次检查连接状态。

你需要提供给 skill 的输入

当你的 prompt 给出明确的 Geokeo 结果目标，而不是只说“use Geokeo”时，这个 skill 的效果最好。建议包含：

• 具体业务目标
• 与 Geokeo 相关的 object、location、account、campaign、record 或 query context
• 任务是 read-only、create/update，还是 destructive
• 你希望返回的输出格式，例如 summary、table、IDs 或 audit notes
• 约束条件，例如“do not create anything until I approve”

较弱的 prompt：

Use geokeo-automation for my task.

更好的 prompt：

Use geokeo-automation to find the current Geokeo tools for checking the status of my Geokeo resources. First call RUBE_SEARCH_TOOLS, verify the geokeo connection is active, then show me the available actions and required fields before executing anything.

后一个版本效果更好，因为它符合该 skill 预期的工作流：先发现 tools，验证连接，检查 schema，然后有控制地执行。

推荐的执行工作流

可靠的 geokeo-automation 使用模式如下：

1. 要求 agent 针对某个具体 Geokeo 任务调用该 skill。
2. 要求先用你的真实 use case 调用 RUBE_SEARCH_TOOLS。
3. 查看返回的 tool slugs、schemas 和 pitfalls。
4. 使用 RUBE_MANAGE_CONNECTIONS 确认 Geokeo connection。
5. 只运行与已发现 schema 匹配的 tool call。
6. 要求最终报告包含使用的 tool、提供的 inputs、result，以及任何未解决字段。

这种方式比直接猜一个 tool call 更慢，但可以减少因 schema 过期或连接状态缺失导致的失败。

优先阅读的 repository 文件

这个 skill 目前主要围绕一个文件：

• SKILL.md

如果你需要确认 prerequisites、MCP assumptions 和准确的 workflow pattern，请在安装前阅读该文件。repository preview 中没有打包脚本、rule folders、reference files 或本地示例，因此是否安装应主要取决于 Rube MCP 工作流是否与你的环境匹配。

geokeo-automation skill 常见问题

没有 Rube MCP 时，geokeo-automation 还有用吗？

没有。该 skill 围绕 Rube MCP tools 设计，尤其是 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。如果没有 Rube MCP access，assistant 仍然可以从概念上讨论 Geokeo，但无法按照该 skill 预期的 automation path 执行。

它相比普通 prompt 好在哪里？

普通 prompt 可能会让 agent 猜测 tool 名称或参数结构。geokeo-automation skill 明确要求 agent 先搜索当前的 Geokeo tools，使用发现到的 schemas，并在执行前验证连接。这就是它主要的可靠性提升。

这个 skill 适合新手吗？

只有在你的 MCP client 已经设置好，或有人能帮你添加 https://rube.app/mcp 时，它才算适合新手。Geokeo connection flow 可能并不复杂，但该 skill 默认你理解 agent 会调用外部 tools，并且在行动前可能需要授权。

什么时候不该使用这个 skill？

当你需要离线分析、仅本地运行的脚本、静态 Geokeo 教程，或不依赖外部 tool discovery 的确定性行为时，不应使用 geokeo-automation。如果你的工作流不允许 AI agent 检查 schemas 或操作已连接的 SaaS tools，它也不适合。

如何改进 geokeo-automation skill

让 prompt 更适合执行 geokeo-automation

要让 geokeo-automation 取得更好效果，请把 prompt 写成明确区分 discovery、approval 和 execution 的流程。例如：

Use geokeo-automation for this Geokeo workflow. First discover relevant tools with RUBE_SEARCH_TOOLS using the use case “review available Geokeo account actions.” Then check whether the geokeo connection is active. Do not execute write actions until you list the exact tool, required fields, and planned inputs.

这会给 agent 一个更安全的计划，并避免过早调用 tools。

避免常见失败模式

最常见的问题可能包括：

• 跳过 RUBE_SEARCH_TOOLS
• 假设 schema 仍然是旧版本且可用
• 在 Geokeo connection 变为 ACTIVE 之前就运行
• 任务描述含糊，没有 object、account 或期望输出
• 没有区分 read-only actions 和 write actions

如果第一次运行失败，不要只是简单重试。应要求 agent 复述已发现的 schema，指出缺失字段，并解释失败原因是 authentication、validation、permissions，还是任务本身不清晰。

为更安全的自动化添加 guardrails

对于接近生产环境的 Workflow Automation，请在 prompt 中加入明确的 guardrails：

• “Read-only first”
• “Ask before create, update, or delete”
• “Show required fields before execution”
• “Return raw IDs and a human-readable summary”
• “Log the tool slug and major inputs used”

这些指令可以提升可审计性，也让 agent 完成 Geokeo 任务后的输出更容易验证。

面向团队改进上游 skill

采用 geokeo-automation 的团队可以通过补充常见 Geokeo use cases 示例、sample prompts、预期的 tool-discovery responses，以及 inactive connections 的 troubleshooting notes 来改进该 skill。再增加一个简短的决策表，用来区分 read、write 和 admin workflows，也能让团队在安装前更容易建立信任。