fireberry-automation

fireberry-automation skill 개요

fireberry-automation이 하는 일

fireberry-automation skill은 AI 에이전트가 Composio의 Rube MCP server를 통해 Fireberry CRM 작업을 자동화할 수 있도록 돕습니다. 핵심 가치는 하드코딩된 CRM 명령어 목록이 아니라, 에이전트가 먼저 현재 Fireberry tool schema를 찾아보고, Fireberry 연결 상태를 확인한 뒤, 작업에 맞는 Rube tool을 실행하도록 안내한다는 데 있습니다.

CRM Operations 팀에 가장 적합한 경우

이 skill은 레코드 찾기, 엔터티 업데이트, CRM 데이터 확인, 여러 단계의 CRM workflow 조율처럼 반복 가능한 Fireberry 작업이 필요한 CRM Operations, RevOps, sales operations, support operations 사용자에게 잘 맞습니다. 특히 Claude나 다른 MCP 지원 assistant가 기억에 의존해 API 형태를 추측하지 않고 Fireberry 안에서 작업하길 원할 때 유용합니다.

핵심 차별점: schema-first 실행

이 skill에서 가장 중요한 규칙은 작업 전에 항상 RUBE_SEARCH_TOOLS를 호출하는 것입니다. 사용 가능한 Fireberry action, 필수 필드, 입력 형식은 바뀔 수 있기 때문입니다. fireberry-automation은 Fireberry 작업을 호출하기 전에 assistant가 현재 tool slug, schema, 권장 실행 계획, 주의할 함정을 먼저 확인하게 만들어 자동화 실패를 줄이도록 설계되어 있습니다.

도입 전 고려할 점

fireberry-automation은 가볍습니다. repository path에는 단일 SKILL.md만 있으며 helper script, examples folder, 추가 rule은 없습니다. 그래서 검토하기 쉽지만, 성공 여부는 MCP client가 올바르게 설정되어 있는지와 prompt에 충분한 CRM context가 들어 있는지에 크게 좌우됩니다. 이미 Rube MCP를 사용 중이거나, 활성 Fireberry connection과 함께 Rube MCP를 사용할 의향이 있다면 도입할 만합니다.

fireberry-automation skill 사용 방법

fireberry-automation 설치 및 연결 설정

Claude skills environment에 skill을 설치합니다. 예를 들면 다음과 같습니다.

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

그다음 client에 다음을 추가해 Rube MCP를 설정합니다.

https://rube.app/mcp

Fireberry 작업을 요청하기 전에 RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인하세요. 이어서 fireberry toolkit에 대해 RUBE_MANAGE_CONNECTIONS를 사용합니다. connection이 ACTIVE가 아니라면 반환된 인증 흐름을 완료한 뒤, CRM workflow를 실행하기 전에 상태를 다시 확인해야 합니다.

skill에 제공해야 할 입력

fireberry-automation을 제대로 활용하려면 비즈니스 목표, Fireberry object 또는 record type, 매칭 필드, 업데이트 필드, 제약 조건, 그리고 에이전트가 실제 변경을 수행해야 하는지 아니면 계획만 준비해야 하는지를 제공해야 합니다. 약한 prompt는 “Update my Fireberry leads.”입니다. 더 나은 prompt는 다음과 같습니다.

“Using fireberry-automation, find Fireberry leads where status = New and source = Webinar, review available Fireberry tools first, then propose an execution plan. Do not update records until I approve. If required fields are missing from the tool schema, ask me before proceeding.”

권장 workflow

하나의 큰 지시로 처리하기보다 단계적으로 진행하세요. 먼저 agent에게 정확한 use case에 맞춰 RUBE_SEARCH_TOOLS로 tool을 찾게 합니다. 둘째, Fireberry connection을 확인하게 합니다. 셋째, 목표를 발견된 tool schema에 매핑하게 합니다. 넷째, 가능하다면 read-only 확인이나 작은 sample로 먼저 검증합니다. 마지막으로 field mapping과 대상 record가 명확해진 뒤에만 write operation을 실행합니다.

먼저 읽어야 할 repository 파일

composio-skills/fireberry-automation/SKILL.md부터 확인하세요. 이 파일에는 prerequisites, Rube MCP 설정, tool discovery, connection check, 핵심 workflow pattern 등 전체 운영 가이드가 들어 있습니다. 함께 제공되는 script나 reference file은 없으므로, 가장 먼저 확인할 것은 사용 중인 MCP client가 필요한 Rube tool을 지원하는지, 그리고 팀의 Fireberry permission이 의도한 작업을 허용하는지입니다.

fireberry-automation skill FAQ

fireberry-automation은 개발자 전용인가요?

아닙니다. Fireberry 작업을 정확하게 설명할 수 있고 MCP 지원 assistant가 설정되어 있다면, 개발자가 아닌 CRM Operations 사용자에게도 유용합니다. 다만 최초 MCP 설정, connection authorization, permission review는 기술 담당자의 도움이 필요할 수 있습니다.

일반 CRM prompt와 무엇이 다른가요?

일반 prompt는 Fireberry field를 허구로 만들어내거나 API 형식을 임의로 가정할 수 있습니다. fireberry-automation skill은 agent에게 먼저 Rube의 현재 Fireberry tool을 검색하고, schema를 검토한 다음 실행하라고 지시합니다. 이 schema-first pattern이 generic CRM instruction에만 의존하지 않고 이 skill을 설치해야 하는 주된 이유입니다.

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

Rube MCP를 사용할 수 없거나, Fireberry connection을 활성화할 수 없거나, prompt에 담기지 않은 비즈니스 판단이 필요한 작업에는 사용하지 마세요. 또한 대상 record, 필수 field, rollback process를 명확히 식별할 수 없다면 직접 write operation을 피하는 것이 좋습니다.

미리 만들어진 Fireberry workflow가 포함되어 있나요?

독립 실행형 script 형태로는 포함되어 있지 않습니다. fireberry-automation은 Rube MCP를 통해 Composio Fireberry tool을 발견하고 사용하는 workflow pattern을 제공합니다. 실제로 사용할 수 있는 action은 RUBE_SEARCH_TOOLS에서 나오므로, discovery가 완료되기 전까지 assistant가 특정 tool slug를 가정해서는 안 됩니다.

fireberry-automation skill 개선 방법

더 명확한 목표로 fireberry-automation 결과 개선하기

가장 빠른 개선 방법은 원하는 CRM 결과를 운영 관점에서 구체적으로 적는 것입니다. record type, filter, 읽거나 업데이트할 field, 허용되는 side effect, 승인 요건, 성공 기준을 포함하세요. 예를 들어 “clean up opportunities”보다 “Create a task for each open opportunity with no next step”가 더 좋습니다. agent가 어떤 object, condition, action을 찾아야 하는지 알 수 있기 때문입니다.

흔한 실패 패턴 예방하기

자주 발생하는 문제로는 RUBE_SEARCH_TOOLS를 건너뛰는 것, Fireberry connection이 ACTIVE가 되기 전에 작업하는 것, 비슷한 field name을 혼동하는 것, 한 번에 너무 많은 record를 업데이트하는 것이 있습니다. 명확한 guardrail을 추가하세요. 예를 들면 “Search tools first,” “show the discovered schema,” “confirm target count before writes,” “ask if a required field is ambiguous.”처럼 지시할 수 있습니다.

첫 출력 이후 반복 개선하기

첫 응답은 최종 자동화가 아니라 계획으로 다루세요. agent에게 발견된 Fireberry tool을 요약하고, 필요한 input을 나열하고, 누락된 값을 식별하고, 어떤 operation이 read-only인지 write-capable인지 설명하게 하세요. 계획이 맞다면, 더 큰 batch로 확장하기 전에 좁은 범위의 실행 단계를 승인하세요.

팀 내부 규칙 추가하기

조직에서 fireberry-automation skill을 더 강하게 활용하려면 자체 CRM naming convention, status definition, required field, approval rule을 함께 제공하세요. “Never modify closed opportunities,” “Use owner email as the primary user identifier,” “All bulk updates require sample validation first” 같은 짧은 내부 메모만으로도 출력 품질을 크게 높일 수 있습니다.