spoki-automation

spoki-automation skill 개요

spoki-automation의 용도

spoki-automation은 Composio의 Rube MCP toolkit을 통해 Spoki 작업을 실행하기 위한 Claude skill입니다. 에이전트가 현재 Spoki tool schema를 탐색하고, Spoki 연결 상태를 확인한 뒤, 오래된 API 가정을 하드코딩하지 않고 지원되는 워크플로 자동화 작업을 실행하길 원하는 사용자를 위해 설계되었습니다.

핵심 가치는 방대한 프롬프트 라이브러리가 아니라 워크플로 규율에 있습니다. 먼저 Rube tool을 검색하고, spoki 연결을 검증하고, 반환된 schema를 확인한 다음, 검증된 입력값으로 선택한 action을 실행하는 방식입니다.

가장 잘 맞는 사용자와 워크플로

이 spoki-automation skill은 이미 Claude를 MCP 및 Composio/Rube와 함께 사용하는 팀에 적합합니다. 특히 Spoki가 메시징, 고객 운영, 캠페인 워크플로의 일부일 때 유용합니다. 원하는 비즈니스 결과는 알고 있지만, 에이전트가 올바른 Spoki tool과 최신 입력 형식을 식별해야 하는 상황에 잘 맞습니다.

좋은 사용 사례로는 에이전트에게 사용 가능한 Spoki action을 찾게 하거나, 인증이 활성화되어 있는지 확인하게 하거나, 구조화된 고객 또는 캠페인 데이터로 tool call을 준비하게 하거나, 실행 전에 필요한 필드를 설명하게 하는 작업이 있습니다.

일반 프롬프트와 다른 점

일반 프롬프트는 tool 이름이나 schema를 추측할 수 있습니다. spoki-automation은 에이전트가 먼저 RUBE_SEARCH_TOOLS를 호출하고, 반환된 tool slug, schema, 실행 계획, 주의사항을 사용하도록 명시합니다. MCP tool 표면은 바뀔 수 있고, 오래된 예시는 자동화 실패의 흔한 원인이기 때문에 이 차이가 중요합니다.

이 skill은 의도적으로 범위가 좁습니다. Spoki를 위한 연결 인식형 Rube MCP 워크플로이지, 독립형 Spoki SDK, CLI, 또는 전체 캠페인 관리 시스템이 아닙니다.

spoki-automation skill 사용 방법

spoki-automation 설치 맥락

Composio skills repository에서 skill을 설치합니다.

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

또한 Claude 호환 클라이언트에 Rube MCP가 구성되어 있어야 합니다. MCP server로 https://rube.app/mcp를 추가한 다음, MCP가 RUBE_SEARCH_TOOLS를 노출하는지 확인하세요. 이 skill은 Rube에 의존하므로 markdown만 설치해서는 충분하지 않습니다.

실제 작업을 실행하기 전에 에이전트에게 toolkit spoki에 대해 RUBE_MANAGE_CONNECTIONS를 호출하라고 요청하세요. 연결 상태가 ACTIVE가 아니라면 반환된 인증 흐름을 완료한 뒤 상태를 다시 확인해야 합니다.

skill 사용을 위해 제공해야 할 입력

spoki-automation을 안정적으로 사용하려면 에이전트에게 구체적인 작업, 대상 Spoki object 또는 workflow, 데이터 소스, 제약 조건, 그리고 action 실행이 가능한지 아니면 계획만 준비해야 하는지를 알려주세요.

약한 프롬프트:

Use Spoki to automate outreach.

더 나은 프롬프트:

Use spoki-automation to discover the current Spoki tools via Rube MCP. Check my spoki connection first. I want to prepare a workflow for sending a WhatsApp-style customer update to a provided list, but do not execute until you show me the required fields, tool slug, schema, and any missing data.

이렇게 작성하면 에이전트가 목표를 현재 tool에 매핑하고, 누락된 필드를 질문하며, 연결 및 schema 확인 전에 실행하지 않도록 만들 수 있어 결과가 좋아집니다.

설치 후 권장 워크플로

composio-skills/spoki-automation의 SKILL.md부터 확인하세요. 이 skill에서 노출되는 유일한 지원 파일입니다. 여기에는 세 가지 운영 규칙이 담겨 있습니다. Rube MCP를 사용할 수 있어야 하고, Spoki 연결이 활성 상태여야 하며, workflow 전에 RUBE_SEARCH_TOOLS를 호출해야 합니다.

실무에서 권장되는 실행 순서는 다음과 같습니다.

1. 에이전트에게 특정 Spoki 작업에 맞는 tool을 검색하라고 요청합니다.
2. 반환된 tool slug, schema, warning을 검토합니다.
3. spoki에 대해 RUBE_MANAGE_CONNECTIONS를 확인하라고 요청합니다.
4. 필요한 비즈니스 데이터를 구조화된 형식으로 제공합니다.
5. 고객에게 영향을 주는 action이라면 실행 전에 dry-run 계획을 요청합니다.

실무 프롬프트 패턴

다음과 같은 프롬프트 형식을 사용하세요.

Use the spoki-automation skill.

Goal: [specific Spoki outcome]
Execution mode: [plan only / execute after confirmation]
Data available: [fields, list source, IDs, message content, timing]
Constraints: [do not send duplicates, require approval, language, segment]
First steps: call RUBE_SEARCH_TOOLS for this exact use case, then check the spoki connection.
Output: show selected tool slug, required schema fields, missing inputs, and proposed execution steps.

이 형식은 에이전트가 Spoki API 형태를 추측하지 않고 탐색과 검증에 집중하도록 도와줍니다.

spoki-automation skill FAQ

spoki-automation은 초보자에게도 적합한가요?

MCP 클라이언트가 이미 구성되어 있다면 초보자도 사용할 수 있습니다. 다만 원클릭 Spoki 자동화 앱은 아닙니다. tool 접근 권한을 부여하고, 연결 흐름을 완료하고, 실행 전에 제안된 tool call을 검토할 수 있어야 합니다. 처음 사용하는 경우에는 먼저 “plan only” 모드로 실행하는 것이 좋습니다.

이 skill을 사용하지 말아야 할 때는 언제인가요?

오프라인 Spoki 문서가 필요하거나, Rube MCP 없이 직접 API 코딩 도움을 원하거나, tool discovery 전에 특정 action 지원을 보장받아야 한다면 spoki-automation을 사용하지 않는 편이 좋습니다. 이 skill의 안내는 live Rube schema에 의존하므로, 사용 가능 여부는 실행 시점에 결정됩니다.

왜 먼저 tool discovery가 필요한가요?

이 repository가 RUBE_SEARCH_TOOLS를 강조하는 이유는 Composio tool schema가 변경될 수 있기 때문입니다. 먼저 검색하면 에이전트가 최신 tool 이름, 필수 필드, 권장 계획, 알려진 주의사항을 확보할 수 있습니다. 이것이 실패하거나 안전하지 않은 자동화를 막는 핵심 안전장치입니다.

Spoki 연결 없이도 작동하나요?

아니요. 이 skill은 연결 상태 확인을 도울 수는 있지만, 실제 Spoki 작업에는 RUBE_MANAGE_CONNECTIONS를 통한 활성 spoki 연결이 필요합니다. 인증이 완료되지 않았다면 모델에 계속 프롬프트를 보내는 것이 아니라, 반환된 auth link를 따라 인증을 완료하는 것이 올바른 다음 단계입니다.

spoki-automation skill 개선 방법

더 나은 작업 정의로 spoki-automation 결과 개선하기

가장 큰 품질 개선은 모호한 자동화 요청을 운영 브리프로 바꾸는 데서 나옵니다. 대상 고객, 메시지 또는 object 유형, 원본 데이터, 필요한 승인, 실행 시점, 성공 기준을 포함하세요. 고객에게 연락이 갈 수 있는 작업이라면 발송 전에 확인 단계를 명시적으로 요구해야 합니다.

개선 예시:

Before executing, summarize the exact records affected, the Spoki tool slug, required fields, and any defaults you will apply. Stop if any recipient identifier is missing.

흔한 실패 패턴 피하기

흔한 장애 요인은 비활성 Spoki 인증, 누락된 수신자 또는 object identifier, 불명확한 실행 권한, 기억에 의존한 tool schema 가정입니다. 해결 방법은 절차를 지키는 것입니다. tool을 검색하고, 연결을 확인하고, 필수 필드를 검증한 다음, 사용자가 계획을 확인한 뒤에만 실행하세요.

에이전트가 discovery를 건너뛰면 다음처럼 다시 지시하세요.

Do not infer the schema. Call RUBE_SEARCH_TOOLS for this Spoki use case and base the next step only on the returned schema.

첫 출력 이후 반복 검토하기

첫 계획이 나온 뒤에는 바로 실행 승인하지 말고 gap check를 요청하세요. 유용한 후속 질문은 다음과 같습니다.

• “Which required fields are still missing?”
• “What records will be affected?”
• “What could cause duplicate or unintended sends?”
• “Show the final tool call inputs before execution.”

이렇게 하면 spoki-automation guide를 단순한 connector가 아니라 더 안전한 workflow automation 검토 루프로 활용할 수 있습니다.

repository에 추가하면 좋은 개선점

upstream skill은 일반적인 Spoki 사용 사례 예시, dry-run prompt template, 비활성 Rube 또는 Spoki 연결에 대한 troubleshooting note가 추가되면 더 강력해질 수 있습니다. 설정 스크린샷이나 클라이언트별 MCP configuration note가 포함된 작은 README.md도 신규 사용자의 도입 장벽을 낮추는 데 도움이 됩니다.