foursquare-automation
作者 ComposioHQfoursquare-automation 可帮助 agent 通过 Composio Rube MCP 自动化 Foursquare 工作流：发现当前可用工具、检查已启用的 Foursquare 连接，并在执行前使用返回的 schemas。
该 skill 评分为 66/100，适合收录但能力边界较明显。目录用户可以看出它用于通过 Composio/Rube MCP 自动化 Foursquare，并且提供了足够的设置与工具发现指引，帮助 agent 以较安全的方式开始使用；但除了通用的工具发现说明之外，它缺少更具体的 Foursquare 工作流内容和安装决策信息。
- 有效的 skill 元数据，并明确说明 MCP 要求：将 Rube MCP 和已启用的 Foursquare 连接列为前置条件。
- 提供了可执行的设置路径：添加 Rube MCP endpoint，验证 RUBE_SEARCH_TOOLS，管理 Foursquare 连接，并在使用前确认 ACTIVE 状态。
- 触发流程约束较强：多次要求 agent 先调用 RUBE_SEARCH_TOOLS，以便在执行前获取当前的 Foursquare tool schemas。
- 除 SKILL.md 外，没有提供支持文件、脚本、参考资料或 README，因此采用该 skill 基本完全依赖文件内的简短说明。
- 内容整体更像是通用的 Rube MCP/Foursquare 工具包封装；从现有信息看，实际场景细节较少，也没有除工具发现和连接检查流程模式之外的具体任务示例。
foursquare-automation skill 概览
foursquare-automation 能做什么
foursquare-automation skill 可帮助 AI agent 通过 Composio 的 Rube MCP server 自动执行 Foursquare 相关操作。它适合这样的工作流：agent 需要先发现当前可用的 Foursquare tool schema，确认 Foursquare 连接处于可用状态，然后调用正确的 Rube tool，而不是凭记忆猜测参数。
最适合的用户与工作流
如果你正在使用 Claude 或其他支持 MCP 的 agent，并希望在更大的自动化流程中执行 Foursquare 相关操作，foursquare-automation skill 会很有用。它尤其适合希望通过 Composio 的 Foursquare toolkit 让 agent 管理场地、位置、发现类任务或账号关联任务的团队；特别是在 tool schema 可能变化、需要运行时检查的场景下更合适。
核心差异：先发现工具，再执行
foursquare-automation skill 的主要价值不是提供一份静态的 Foursquare 命令列表。它的核心指令是在执行前先调用 RUBE_SEARCH_TOOLS，让 agent 获取当前的 tool slug、schema、执行计划和常见风险点。相比依赖通用 prompt、假设旧 API 字段或编造不受支持参数的做法，这种方式更安全。
安装前需要了解的事项
该仓库路径下只有 SKILL.md，因此能否顺利采用取决于你的客户端是否已经支持 MCP，以及是否已配置 Rube。该 skill 需要 rube MCP server，并且需要通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit foursquare 建立一个有效的 Foursquare 连接。如果你无法添加 MCP server，或无法完成 Foursquare 授权，这个 skill 就不能执行真实操作。
如何使用 foursquare-automation skill
foursquare-automation 安装环境
使用你的 skill manager 从 skill 仓库安装，例如：
npx skills add ComposioHQ/awesome-claude-skills --skill foursquare-automation
然后在客户端配置中加入 Rube MCP：
https://rube.app/mcp
安装后，确认 agent 可以访问 RUBE_SEARCH_TOOLS。上游 skill 说明 MCP endpoint 不需要 API key，但 Foursquare 操作仍然需要有效的 toolkit connection。使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit foursquare；如返回授权链接，请按提示完成授权，并确认连接状态为 ACTIVE。
使用时需要你提供哪些输入
为了获得更好的 foursquare-automation usage 效果，请向 agent 提供实际的 Foursquare 任务、账号或场地上下文、预期结果，以及任何安全限制。较弱的 prompt 是：“Use Foursquare.” 更好的 prompt 是：“Using the foursquare-automation skill, find the current Rube tools for Foursquare, confirm my Foursquare connection is active, then identify the tool and required fields for updating venue information. Do not execute changes until you show me the proposed parameters.”
这样效果更好，因为 agent 会明确知道：先发现工具、检查授权、把规划和执行分开，并且在没有确认前避免执行不可逆的更新。
推荐工作流
建议先做一轮规划：
- 要求 agent 阅读
composio-skills/foursquare-automation/SKILL.md。 - 让它针对具体用例调用
RUBE_SEARCH_TOOLS，不要只给出笼统的 “Foursquare operations” 查询。 - 让它检查返回的 schema 和推荐执行计划。
- 通过
RUBE_MANAGE_CONNECTIONS确认 Foursquare 连接。 - 只有在必填字段、账号上下文和预期结果都清楚后再执行。
例如可以这样说：“Search Rube tools for the use case ‘retrieve Foursquare venue details by location name and city,’ summarize the available tool schemas, then ask me for any missing required fields before calling a tool.”
优先阅读的仓库文件
先阅读 SKILL.md，因为这个文件包含该 skill 可用的全部实现指导：前置条件、设置方式、工具发现流程和核心工作流模式。这个 skill 文件夹中没有单独的 README.md、resources/、rules/ 或辅助脚本，因此不要期待内置示例或自定义校验代码。它的实际价值来自运行时的 Rube tool discovery 步骤。
foursquare-automation skill 常见问题
没有 Rube MCP，foursquare-automation 还能用吗？
不能。foursquare-automation skill 是面向 Rube MCP 的路由与工作流指令层。它不包含独立的 Foursquare API client、本地脚本或内置凭据。你需要一个支持 MCP 的客户端、Rube MCP endpoint，以及一个有效的 Foursquare connection。
它比普通 prompt 好在哪里？
普通 prompt 可能只是让模型 “use Foursquare”，但模型可能会猜测 tool name 或使用过期字段。这个 skill 明确要求 agent 先用 RUBE_SEARCH_TOOLS 搜索工具，使用返回的 schema，并在执行前验证连接状态。这能减少参数错误，也让工作流更能适应 toolkit 的变化。
初学者适合使用吗？
可以，前提是你能接受添加 MCP server，并按授权链接完成连接。但它不是一个独立的 Foursquare 入门教程。该 skill 假设 agent 可以调用 Rube tools，并且你理解“发现工具”“检查连接”和“执行操作”之间的区别。
什么时候不应该使用这个 skill？
如果你只需要静态的 Foursquare 文档、你的环境无法运行 MCP tools，或你需要离线自动化，就不适合使用 foursquare-automation。如果你无法授权 Foursquare 账号，或者你的所有操作都必须以可审计的本地代码实现，而不是通过 Rube 中介执行，它也不是理想选择。
如何改进 foursquare-automation skill 的使用效果
让 prompt 精确对应 Foursquare 任务
提升 foursquare-automation 结果的最佳方式，是清楚描述具体要完成的任务。说明你希望搜索、检索、创建、更新还是分析 Foursquare 数据；提供场地、地点或位置上下文；并明确 agent 应该直接执行，还是只准备计划。具体的用例能带来更准确的 RUBE_SEARCH_TOOLS 结果和更清晰的 schema。
增加执行前保护措施
对于写入类操作，要求 agent 在执行前暂停，并展示所选 tool slug、必填字段、可选字段、推断出的值以及风险。一个有力的指令是：“Do not call the final mutation tool until I approve the parameter object.” 对于会影响场地或账号关联数据的更改，这一点尤其重要，因为错误字段可能会影响线上 Foursquare 数据。
处理常见失败模式
最常见的阻塞点包括：缺少 Rube MCP 访问权限、Foursquare 授权未激活、工具搜索查询过于模糊，以及跳过发现步骤导致 schema 不匹配。如果调用失败，不要盲目重试。要求 agent 针对精确任务重新运行 RUBE_SEARCH_TOOLS，重新检查 RUBE_MANAGE_CONNECTIONS，将失败的 payload 与当前 schema 对比，然后生成修正后的 payload。
根据第一轮输出继续迭代
在第一份计划或第一次 tool call 之后，用具体反馈继续收窄范围，例如：“Use the returned schema only,” “ask for missing required fields,” “show the execution plan before acting,” 或 “limit results to this city/account/context.” foursquare-automation skill 的最佳使用方式，是在 agent 执行外部 Foursquare 操作之前，通过每一步持续减少不确定性。