heyreach-automation
作者 ComposioHQheyreach-automation 可帮助 agent 通过 Composio Rube MCP 运行 Heyreach Sales Outreach 工作流：先发现可用 tools，检查是否存在 ACTIVE 连接，并在执行前使用最新 schemas。
该 skill 评分为 68/100，表示可以收录，但更适合作为轻量级集成指南展示，而不是完整打包的 automation skill。目录用户可以了解何时使用它，以及 agent 应如何通过 Rube MCP 发起 Heyreach 操作；但实际采用仍取决于动态 tool discovery 和外部连接配置。
- 触发条件和范围清晰：frontmatter 与标题明确指向通过 Composio/Rube MCP 进行 Heyreach automation。
- 包含具体的前置条件和设置步骤，包括添加 https://rube.app/mcp，并确认 RUBE_SEARCH_TOOLS 以及 Heyreach 连接状态。
- 提供可复用的工作流模式：先搜索 tools，再检查连接，最后使用当前 schemas 执行，有助于减少因工具信息过期导致的错误。
- 执行依赖已连接的 Rube MCP，以及通过 RUBE_MANAGE_CONNECTIONS 确认为 ACTIVE 的 Heyreach 连接；该 skill 不能单独使用。
- 操作指引依赖实时的 RUBE_SEARCH_TOOLS 发现，而不是随包提供的 schemas、scripts 或细分任务配方，因此 agent 仍可能需要自行推断准确输入。
heyreach-automation skill 概览
heyreach-automation 能做什么
heyreach-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Heyreach 相关操作。它不会猜测工具名称，也不会依赖可能过时的 API 假设；这个 skill 的核心模式是先搜索 Rube tools，确认当前有效的 Heyreach connection，然后使用 Rube 返回的最新 schema 执行选定 workflow。
最适合 Sales Outreach 工作流
heyreach-automation skill 最适合正在用 Heyreach 做 Sales Outreach 的团队：他们希望让 AI assistant 协助处理 campaign 相关任务，而不是手动点完平台里的每一步。它适用于 assistant 需要通过 Rube MCP 实时访问可用 Heyreach toolkit 的场景，例如发现当前支持的操作、准备执行输入，并按照 tool-driven plan 推进。
这个 skill 的差异点
它的关键差异不在于一段很长的 prompt template，而在于强制采用 discovery-first workflow。Heyreach 和 Composio 的 tool schema 都可能变化，因此这个 skill 会要求 agent 在执行前先调用 RUBE_SEARCH_TOOLS，并使用返回的 tool slugs、schemas、execution plans 和 pitfalls。相比泛泛地写一句“automate Heyreach”的 prompt，这种方式更安全，因为后者可能会幻觉出不存在的字段，或调用当前不可用的 action。
采用前的重要要求
只有当你的 AI client 支持 MCP，并且能够连接到 Rube 时，这个 skill 才有意义。你还需要通过 RUBE_MANAGE_CONNECTIONS，使用 toolkit heyreach 建立一个 active Heyreach connection。如果你的 client 无法使用 MCP tools，heyreach-automation 就无法发挥它原本设计的价值。
如何使用 heyreach-automation skill
heyreach-automation 的安装与设置路径
从 Composio skill collection 安装这个 skill：
npx skills add ComposioHQ/awesome-claude-skills --skill heyreach-automation
然后在你的 client configuration 中把 https://rube.app/mcp 添加为 MCP server。上游 skill 说明 MCP endpoint 本身不需要 API keys，但你仍然必须通过 Rube 连接 Heyreach。先确认 RUBE_SEARCH_TOOLS 可用，再使用 toolkit heyreach 调用 RUBE_MANAGE_CONNECTIONS。在 connection status 变为 ACTIVE 之前，不要执行任何 outreach operations。
这个 skill 需要你提供哪些输入
像“do Heyreach automation”这样模糊的请求，会让 agent 缺少必要上下文。更好的 heyreach-automation 使用 prompt 应包含：
- 业务目标：campaign setup、lead handling、status review，或其他 Heyreach task
- 你关注的具体对象：campaign、lead list、account、inbox、sequence，或 report
- 约束条件：不要发送消息、只起草修改、限制在指定 campaign 内、避免修改 active campaigns
- 期望输出：直接执行任务、返回计划、总结 tool options，或先请求确认
示例 prompt：“Use heyreach-automation for Sales Outreach. First discover current Heyreach tools with Rube. I want to review available actions for updating prospects in campaign Q1 SaaS Founders, but do not modify anything until I approve the exact tool call and fields.”
首次运行的推荐流程
第一次使用时，建议先做一次非破坏性的 discovery run。让 agent 针对你的具体任务调用 RUBE_SEARCH_TOOLS，并在采取行动前解释可用 tools。接着，让它通过 RUBE_MANAGE_CONNECTIONS 检查 Heyreach connection。只有这两步都完成后，才允许执行。
一个实用顺序是：
- “Search current Heyreach tools for this task.”
- “Show the returned schema and required fields.”
- “Confirm my Heyreach connection is active.”
- “Propose the exact tool call and risk level.”
- “Execute only after confirmation.”
这样可以减少调用失败、意外修改 campaign，以及 schema mismatch errors。
安装前应先查看的 repository 文件
这个 skill 很精简：最值得先读的是 composio-skills/heyreach-automation 里的 SKILL.md。在提供的目录树中，没有单独的 README.md、scripts/、rules/、resources/ 或 references/ 文件夹，所以它的操作价值主要集中在 prerequisites、setup、tool discovery 和 core workflow 相关部分。安装前请确认你的 agent environment 确实能暴露 Rube MCP tools；否则，仅有这个文件本身并不能自动化 Heyreach。
heyreach-automation skill 常见问题
heyreach-automation 对新手友好吗？
只有在你的 client 已经支持 MCP tools，或者你熟悉 MCP server 配置时，它才算对新手友好。workflow 的表达并不复杂，但这个 skill 依赖实时 tool calls，例如 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。非技术用户可能需要他人协助完成初始 MCP setup 和 Heyreach authorization。
没有 Heyreach 账号可以用吗？
不可以。这个 skill 是围绕 Composio 的 Heyreach toolkit 设计的。你需要一个 Heyreach 账号，并且要通过 Rube 建立 active connection。没有这个连接时，assistant 可以讨论可能的 workflow，但无法执行真正的 Heyreach automation。
它为什么比普通 prompt 更好？
普通 prompt 可能会编造 Heyreach API 字段，或假设一些已经过时的 action。heyreach-automation 会指示 agent 在行动前先发现当前 tool schema。对 Sales Outreach operations 来说，这一点尤其重要，因为错误字段或非预期更新可能影响正在运行的 campaigns 和 prospect communication。
什么时候不应该使用这个 skill？
如果你的任务属于 Heyreach toolkit 之外的不支持渠道、client 无法使用 MCP tools，或你打算在没有审核的情况下让系统完全自主修改 campaign，都不适合使用它。如果你的目标只是撰写 outreach copy，copywriting skill 可能更合适。heyreach-automation 最擅长的是需要通过 Rube 执行实时 Heyreach operations 的任务。
如何改进 heyreach-automation skill 的使用效果
为 heyreach-automation 提供更明确的任务上下文
想要得到更好的结果，就要明确具体的操作边界。不要只说“update my campaign”，可以这样说：“Search for tools that can inspect campaign settings. If a modification tool exists, show required fields and wait before changing anything.” 这能帮助 skill 选择正确的 Rube discovery query，并避免过早执行。
用确认检查点控制风险
最重要的改进方式，是把 discovery、planning 和 execution 分开。任何 write action 之前都应要求确认检查点，尤其是当 campaigns、prospects、sending rules 或 account settings 可能被改变时。你也可以要求 “read-only first”，强制 assistant 先收集可用选项，再进行修改。
留意常见失败模式
常见阻碍包括 Heyreach connection status 不是 active、RUBE_SEARCH_TOOLS 不可用、目标描述太模糊、缺少 campaign identifiers，以及对 tool inputs 使用了过时假设。如果第一次尝试失败，不要只是重复重试。应要求 agent 针对更窄的 use case 重新运行 tool discovery，并把所需 schema 与你已提供的字段逐项对照。
根据第一次输出继续迭代
拿到第一次 tool discovery result 后，用 Rube 返回的实际 tool names 和 required fields 来优化 prompt。例如：“Using the discovered schema, prepare the minimal safe call for this campaign, leave optional fields blank unless required, and explain any field you cannot infer.” 这样可以把 heyreach-automation 从宽泛的 automation helper，转变为更可控的 Heyreach execution workflow。