piggy-automation

piggy-automation skill 개요

piggy-automation의 용도

piggy-automation은 Composio의 Rube MCP server를 통해 Piggy 작업을 자동화하는 Claude skill입니다. Piggy API 호출을 하드코딩하는 대신, 에이전트가 런타임에 현재 Piggy tool schema를 탐색하고, 사용자의 Piggy 연결 상태를 확인한 뒤, 요청된 워크플로를 Rube를 통해 실행하도록 안내합니다.

이 piggy-automation skill은 이미 Claude 호환 MCP client를 사용하고 있으며, 매번 작업 전에 Composio tool documentation을 직접 뒤지지 않고도 더 안전하고 schema를 인식하는 방식으로 Piggy 작업을 실행하고 싶은 사용자에게 가장 적합합니다.

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

piggy-automation skill은 더 넓은 AI workflow 안에서 반복 가능한 Piggy 작업이 필요한 팀이나 운영자에게 잘 맞습니다. 특히 사용 가능한 정확한 tool이나 field가 바뀔 수 있는 환경에서 유용합니다. 다음과 같은 경우에 적합합니다.

• 현재 사용할 수 있는 Piggy tool을 탐색해야 할 때
• 실행 전에 Piggy connection이 활성 상태인지 확인해야 할 때
• 자연어로 작성한 작업 요청을 Rube MCP 실행 계획으로 매핑해야 할 때
• input field나 tool name에 대한 오래된 가정을 피하고 싶을 때

단, 이것은 독립형 Piggy client가 아닙니다. Rube MCP와 인증된 Piggy connection에 의존합니다.

핵심 차별점: 먼저 tool 검색

이 skill에서 가장 중요한 동작은 “항상 먼저 검색”하는 패턴입니다. 에이전트는 Piggy workflow를 실행하기 전에, 사용자의 구체적인 작업을 search query로 삼아 RUBE_SEARCH_TOOLS를 호출해야 합니다. 이렇게 하면 현재 tool slug, schema, 권장 plan, 알려진 주의점까지 확인할 수 있어, 모델이 기억에 의존해 추측하는 것보다 훨씬 안정적입니다.

도입 전에 알아야 할 제약

piggy-automation을 설치하기 전에, 사용 중인 client가 MCP tool을 지원하고 https://rube.app/mcp에 연결할 수 있는지 확인하세요. 또한 toolkit piggy에 대해 RUBE_MANAGE_CONNECTIONS로 관리되는 활성 Piggy connection이 필요합니다. 현재 환경에서 Claude에 MCP tool을 노출할 수 없다면, 이 skill만으로는 실질적인 도움이 되기 어렵습니다.

piggy-automation skill 사용 방법

piggy-automation 설치 및 설정 경로

호환되는 skills 환경에 skill을 설치합니다. 예시는 다음과 같습니다.

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

그다음 client에 아래 MCP server endpoint를 추가해 Rube MCP를 설정합니다.

https://rube.app/mcp

설치 후에는 먼저 composio-skills/piggy-automation/SKILL.md를 여세요. 이 repository는 skill instructions가 SKILL.md에 집중된 간결한 구조입니다. 따라서 별도로 살펴봐야 할 rules/, scripts/, resources/ 폴더는 없습니다.

작업 실행 전 필수 connection 확인

좋은 piggy-automation 사용 흐름은 tool과 connection 검증에서 시작합니다.

1. RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인합니다.
2. toolkit piggy로 RUBE_MANAGE_CONNECTIONS를 사용합니다.
3. Piggy가 ACTIVE 상태가 아니라면, 반환된 authorization link를 따라 인증합니다.
4. workflow를 실행하기 전에 connection status를 다시 확인합니다.
5. 수행하려는 구체적인 Piggy task에 대해 RUBE_SEARCH_TOOLS를 호출합니다.

이 순서는 중요합니다. discovery를 건너뛰면 에이전트가 오래된 field name을 사용할 수 있습니다. connection check를 생략하면 plan을 이미 만든 뒤에 workflow가 실패할 수 있습니다.

막연한 목표를 좋은 prompt로 바꾸기

약한 prompt는 다음과 같습니다. “Use Piggy to do this task.”

piggy-automation skill에 더 적합한 prompt는 다음과 같습니다.

Use the piggy-automation skill. First call RUBE_SEARCH_TOOLS for the specific Piggy operation I describe, then check my Piggy connection with RUBE_MANAGE_CONNECTIONS. If the connection is active, propose the execution plan and required fields before running it. My task is: [describe the Piggy action, target object, filters, dates, account/store/customer context, and expected output].

수행할 action, 관심 있는 object, 제약 조건, 반환받고 싶은 결과를 포함하세요. 예를 들어 요약이 필요한지, 생성/수정된 record가 필요한지, lookup인지, 실행 전 confirmation이 필요한지 명확히 적는 것이 좋습니다.

안정적인 결과를 위한 실전 workflow

실제 데이터에 영향을 주는 작업이라면 piggy-automation을 두 단계로 나눠 사용하세요.

1. Discovery and plan: 에이전트에게 Piggy tool을 검색하고, schema를 확인하고, required field를 식별한 뒤, 제안된 call을 보여 달라고 요청합니다.
2. Execution: 필요한 input과 side effect가 명확해진 뒤에만 plan을 승인합니다.

이 패턴은 update, creation, redemption, account 관련 작업처럼 잘못된 field나 target이 원치 않는 변경을 일으킬 수 있는 경우 특히 중요합니다.

piggy-automation skill FAQ

piggy-automation은 Claude 전용인가요?

이 skill은 Claude 방식의 skill execution과 MCP tool 사용을 염두에 두고 작성되었지만, 실제 workflow는 Rube MCP와 Composio의 Piggy toolkit에 의존합니다. 다른 agent 환경이 skill instructions를 로드하고 동일한 MCP tool을 호출할 수 있다면 이 패턴을 응용할 수 있습니다. 가장 쉬운 경로는 skills와 MCP를 지원하는 Claude 호환 client를 사용하는 것입니다.

일반 prompt보다 나은 점은 무엇인가요?

일반 prompt는 모델에게 “use Piggy”라고 요청할 수는 있지만, tool discovery, connection validation, schema checking을 반드시 수행하게 만들지는 못할 수 있습니다. piggy-automation skill은 이 단계를 기본 운영 절차로 내장합니다. 그만큼 추측을 줄이고, 에이전트가 현재 Piggy toolkit을 올바르게 사용할 가능성을 높입니다.

사용 전에 무엇을 확인해야 하나요?

Workflow Automation에 piggy-automation을 신뢰하고 사용하기 전에 다음을 확인하세요.

• 사용 중인 client에서 RUBE_SEARCH_TOOLS가 응답하는지
• RUBE_MANAGE_CONNECTIONS가 Piggy toolkit을 조회하거나 관리할 수 있는지
• Piggy connection status가 ACTIVE인지
• 검색된 tool schema가 의도한 작업과 일치하는지
• 해당 operation이 read-only인지, 데이터를 변경하는 작업인지 이해하고 있는지

piggy-automation을 쓰지 말아야 할 때는 언제인가요?

정적 문서만 필요하거나, client가 MCP server에 연결할 수 없거나, Piggy task에 개발자의 사전 검토가 필요한 custom business logic이 포함되어 있다면 사용하지 않는 편이 좋습니다. 또한 민감한 작업은 에이전트가 발견한 tool, required input, 예상 side effect를 먼저 보여주기 전까지 직접 실행하지 않는 것이 안전합니다.

piggy-automation skill 개선 방법

piggy-automation에 더 좋은 task input 제공하기

이 skill은 단순한 의도보다 실제 운영에 필요한 세부 정보가 prompt에 들어 있을 때 가장 잘 작동합니다. 다음을 제공하세요.

• 원하는 정확한 Piggy task
• 관련 identifier, name, date, filter, account context
• task가 lookup, creation, update, deletion, reporting 중 무엇인지
• 필요한 output format
• 실행 전에 에이전트가 확인을 요청해야 하는지 여부

이렇게 하면 RUBE_SEARCH_TOOLS가 더 관련성 높은 tool match를 반환하고, 에이전트가 지나치게 넓은 operation을 선택하는 일을 줄일 수 있습니다.

예방해야 할 흔한 실패 패턴

가장 흔한 실패는 schema discovery를 건너뛰고 추정한 tool field에 의존하는 것입니다. 또 다른 실패는 Piggy connection이 활성화되기 전에 실행을 시도하는 경우입니다. 세 번째는 목표가 너무 모호해 tool search가 지나치게 일반적으로 수행되는 경우입니다.

이를 막으려면 에이전트에게 다음을 명시적으로 지시하세요. 정확한 use case를 검색하고, connection status를 확인하고, required field를 나열하고, execution tool을 호출하기 전에 누락된 값을 물어보게 하세요.

첫 결과 이후 반복 개선하기

첫 tool search가 끝났다면 곧바로 실행으로 넘어가지 말고 workflow를 다듬으세요. 다음을 물어보면 좋습니다.

• 어떤 Piggy tool slug가 권장되며, 그 이유는 무엇인가요?
• required field와 optional field는 각각 무엇인가요?
• 이 call은 어떤 side effect를 일으키나요?
• 실행 전에 어떤 validation을 할 수 있나요?
• 먼저 read-only lookup으로 실행해 볼 수 있나요?

이렇게 하면 piggy-automation을 단순한 connector가 아니라 더 안전한 workflow automation assistant로 활용할 수 있습니다.

팀에 맞게 skill instructions 개선하기

내부 버전을 관리한다면, 팀에서 가장 자주 쓰는 Piggy workflow 예시, 승인된 naming convention, 필수 review step, 민감한 action에 대한 “never execute without confirmation” rule을 추가하세요. 단, 핵심 요구사항은 그대로 유지해야 합니다. 항상 먼저 RUBE_SEARCH_TOOLS를 호출해야 skill이 오래된 가정이 아니라 최신 Composio Piggy schema를 따를 수 있습니다.