heyreach-automation

heyreach-automation skill 개요

heyreach-automation의 역할

heyreach-automation은 Composio의 Rube MCP server를 통해 Heyreach 작업을 실행하기 위한 Claude skill입니다. 도구 이름을 추측하거나 오래된 API 가정에 기대는 대신, 이 skill의 핵심 방식은 먼저 Rube tools를 검색하고, 활성 Heyreach 연결을 확인한 뒤, Rube가 반환한 최신 schema에 맞춰 선택한 workflow를 실행하는 것입니다.

Sales Outreach workflow에 가장 잘 맞는 경우

heyreach-automation skill은 Heyreach로 Sales Outreach를 운영하면서, 플랫폼의 모든 단계를 직접 오가며 처리하지 않고 AI assistant가 campaign 관련 작업을 도와주길 원하는 팀에 특히 유용합니다. Rube MCP를 통해 사용할 수 있는 Heyreach toolkit에 assistant가 실시간으로 접근해야 하는 workflow, 예를 들어 지원되는 작업을 찾고, 실행 입력값을 준비하며, tool 기반 계획을 따라야 하는 경우에 잘 맞습니다.

이 skill이 다른 점

핵심 차별점은 긴 prompt template이 아니라, “먼저 발견하고 나중에 실행”하도록 강제하는 workflow입니다. Heyreach와 Composio tool schema는 바뀔 수 있으므로, 이 skill은 agent에게 실행 전에 RUBE_SEARCH_TOOLS를 호출하고 반환된 tool slugs, schemas, execution plans, pitfalls를 사용하라고 지시합니다. 그래서 존재하지 않는 field를 지어내거나 사용할 수 없는 action을 호출할 수 있는 일반적인 “Heyreach 자동화” prompt보다 더 안전합니다.

도입 전에 꼭 확인할 조건

이 skill은 AI client가 MCP를 지원하고 Rube에 연결할 수 있을 때만 의미가 있습니다. 또한 toolkit heyreach를 사용해 RUBE_MANAGE_CONNECTIONS에서 활성 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로 추가합니다. upstream skill 설명에 따르면 MCP endpoint 자체에는 API key가 필요하지 않지만, Heyreach는 Rube를 통해 별도로 연결해야 합니다. RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인한 뒤, toolkit heyreach로 RUBE_MANAGE_CONNECTIONS를 사용하세요. connection status가 ACTIVE가 되기 전에는 outreach 작업을 실행하지 마세요.

skill에 제공해야 할 입력값

“do Heyreach automation”처럼 막연한 요청은 agent에게 필요한 맥락을 충분히 주지 못합니다. 더 좋은 heyreach-automation 사용 prompt에는 다음이 포함됩니다.

• 비즈니스 목표: campaign setup, lead handling, status review 또는 다른 Heyreach task
• 관심 있는 정확한 객체: campaign, lead list, account, inbox, sequence 또는 report
• 제약 조건: message를 보내지 말 것, 변경안만 draft할 것, 특정 campaign으로 제한할 것, active campaigns 수정은 피할 것
• 원하는 결과: task 실행, plan 반환, tool option 요약, 또는 먼저 확인 요청

예시 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.”

첫 실행에 권장하는 workflow

처음에는 파괴적 변경이 없는 discovery 실행부터 시작하세요. agent에게 특정 task에 대해 RUBE_SEARCH_TOOLS를 호출하고, 실제 action을 수행하기 전에 사용할 수 있는 tools를 설명하게 하세요. 그다음 RUBE_MANAGE_CONNECTIONS로 Heyreach connection을 확인하게 합니다. 두 단계를 모두 마친 뒤에만 실행을 허용하는 것이 좋습니다.

실무적으로는 다음 순서가 좋습니다.

1. “Search current Heyreach tools for this task.”
2. “Show the returned schema and required fields.”
3. “Confirm my Heyreach connection is active.”
4. “Propose the exact tool call and risk level.”
5. “Execute only after confirmation.”

이렇게 하면 실패한 호출, 의도치 않은 campaign 변경, schema 불일치 오류를 줄일 수 있습니다.

먼저 확인할 repository 파일

이 skill은 구성이 간결합니다. 먼저 읽어야 할 핵심 파일은 composio-skills/heyreach-automation의 SKILL.md입니다. 제공된 tree에는 별도의 README.md, scripts/, rules/, resources/, references/ 폴더가 없으므로, 운영상의 가치는 prerequisite, setup, tool discovery, core workflow 섹션에 집중되어 있습니다. 설치 전에 agent 환경이 실제로 Rube MCP tools를 노출할 수 있는지 확인하세요. 그렇지 않으면 파일만으로는 Heyreach를 자동화할 수 없습니다.

heyreach-automation skill FAQ

heyreach-automation은 초보자에게도 쉬운가요?

client가 이미 MCP tools를 지원하거나 MCP server 설정에 익숙하다면 초보자도 사용할 수 있습니다. workflow 설명 자체는 어렵지 않지만, 이 skill은 RUBE_SEARCH_TOOLS, RUBE_MANAGE_CONNECTIONS 같은 실시간 tool call에 의존합니다. 비기술 사용자는 초기 MCP 설정과 Heyreach authorization 과정에서 도움이 필요할 수 있습니다.

Heyreach 계정 없이 사용할 수 있나요?

아니요. 이 skill은 Composio의 Heyreach toolkit을 전제로 설계되었습니다. Heyreach 계정과 Rube를 통한 활성 connection이 필요합니다. 이 connection이 없으면 assistant가 가능한 workflow를 설명할 수는 있지만, 실제 Heyreach automation을 수행할 수는 없습니다.

일반 prompt보다 어떤 점이 더 나은가요?

일반 prompt는 Heyreach API field를 지어내거나 오래된 action을 가정할 수 있습니다. heyreach-automation은 agent가 action을 수행하기 전에 현재 tool schema를 먼저 발견하도록 지시합니다. 이는 잘못된 field나 의도치 않은 update가 live campaigns와 prospect communication에 영향을 줄 수 있는 Sales Outreach 작업에서 특히 중요합니다.

언제 이 skill을 사용하지 않는 것이 좋나요?

Heyreach toolkit 밖의 지원되지 않는 channel, MCP tools를 사용할 수 없는 client, 검토 없는 완전 자율 campaign 변경에는 사용하지 마세요. 목표가 outreach copy 작성뿐이라면 copywriting skill이 더 적합할 수 있습니다. heyreach-automation은 Rube를 통해 실제 Heyreach 작업을 수행해야 할 때 가장 강력합니다.

heyreach-automation skill 개선 방법

heyreach-automation에 더 명확한 task 맥락 제공하기

더 좋은 결과를 얻으려면 정확한 운영 범위를 지정하세요. “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을 분리하는 것입니다. campaign, prospect, sending rules, account settings가 바뀔 수 있는 write action 전에는 반드시 확인 지점을 요청하세요. 또한 “read-only first”를 요청해 assistant가 변경 전에 사용 가능한 option을 먼저 수집하도록 강제할 수 있습니다.

흔한 실패 요인 점검하기

흔한 blocker에는 비활성 Heyreach connection status, 사용할 수 없는 RUBE_SEARCH_TOOLS, 모호한 목표, 누락된 campaign identifier, tool input에 대한 오래된 가정이 포함됩니다. 첫 시도가 실패했다면 단순히 재시도하지 마세요. agent에게 더 좁은 use case로 tool discovery를 다시 실행하고, required schema를 사용자가 제공한 field와 비교하라고 요청하세요.

첫 결과 이후 반복 개선하기

첫 tool discovery 결과가 나온 뒤에는 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 실행 workflow로 바꿀 수 있습니다.