Agent-Skills.md

Agent Skills: using-vox-skills

Use FIRST — before any other vox skill — when a user asks anything related to vox.ai: voice agent creation, prompt writing, flow design, tool setup, pricing, MCP connection, web app usage, testing, deployment, or general platform questions. Always route through this skill instead of calling vox domain skills directly. Trigger on '프롬프트 작성해줘', '요금이 얼마예요', 'MCP 연결', 'flow 설계', '도구 추가', '웹 앱 안내', '에이전트 만들어줘', '전화 걸어줘', '음성 AI', '통화 기록', '대량발신', or any vox.ai-related request.

UncategorizedID: fleek-fitness/vox-skills/using-vox-skills

Repository

fleek-fitness/vox-skills
vox-public

Install this agent skill to your local

pnpm dlx add-skill https://github.com/vox-public/vox-skills/tree/HEAD/skills/using-vox-skills

Skill Files

Browse the full folder contents for using-vox-skills.

Download Skill

Loading file tree…

skills/using-vox-skills/SKILL.md

Skill Metadata

Name
using-vox-skills
Description
"Use FIRST — before any other vox skill — when a user asks anything related to vox.ai: voice agent creation, prompt writing, flow design, tool setup, pricing, MCP connection, web app usage, testing, deployment, or general platform questions. Always route through this skill instead of calling vox domain skills directly. Trigger on '프롬프트 작성해줘', '요금이 얼마예요', 'MCP 연결', 'flow 설계', '도구 추가', '웹 앱 안내', '에이전트 만들어줘', '전화 걸어줘', '음성 AI', '통화 기록', '대량발신', or any vox.ai-related request."

using-vox-skills

vox.ai 관련 요청의 routing entrypoint. domain 로직을 직접 실행하지 않고, 요청에 맞는 domain skill을 선택한다.

Skill Catalog

| Skill | Trigger | Owns | Does Not Own | |-------|---------|------|--------------| | vox-onboarding | 시작/온보딩, 에이전트 만들기, 전화 걸기/받기, MCP 연결 설정, 일반 안내 | onboarding, quickstart, 에이전트 생성 가이드, 전화 실행, MCP 서버 연결 설정 | prompt 세부 작성, flow 설계, 도구 관리 | | vox-agents | prompt 작성/리팩터링/진단, agent.data, 에이전트 유형 판단 | prompt authoring, diagnosis, revision, agent.data, voice AI playbook, agent type 판단 | flow 설계, tool management, web app UI | | vox-flow | flow 설계/노드 변환/리뷰, 스크립트 시각화, 변수 시스템 | flow design, node conversion, variable system, flow sketch, flow review | prompt authoring, tool management | | vox-tools | 빌트인/커스텀 도구 관리 | built-in tools, custom tools, tool workflow | prompt authoring, flow design | | vox-web-app | 웹 앱 UI 사용법, 딥링크, UI 전용 흐름(보이스 클론, CSV 업로드, 녹취 재생, 결제, 멤버 초대) | web app UI usage, navigation, deep links, UI-only flows, voice clone, CSV upload, call playback, billing, member management | prompt authoring, flow design, tool management |

Docs MCP 활용

vox-docs MCP 서버(https://docs.tryvox.co/mcp)는 vox.ai 공식 문서 ~85페이지를 실시간 검색한다. 스킬이 커버하지 않는 영역(요금/빌링, SDK, 보안, 배포 상세, 모니터링, API reference 등)은 docs MCP로 직접 답변한다.

사용 방법:

  1. vox-docs MCP의 search tool로 검색 (query 예: "pricing", "SDK javascript", "webhook", "SIP telephony")
  2. 검색 결과에서 관련 페이지를 찾으면 get_page tool로 전문 조회
  3. 페이지 내용 기반으로 답변

docs MCP는 router가 직접 처리하는 유일한 케이스다 — 단순 검색 후 전달이므로 domain skill 수준의 로직이 불필요하기 때문이다.

Routing Rules

  1. 1% rule — 요청이 1%라도 특정 domain skill에 해당되면 해당 skill을 invoke한다. domain skill 내부에 사실 검증과 가드레일이 있어, router가 직접 답하면 이를 우회하게 된다.
  2. One primary skill — 한 요청에는 하나의 primary skill만 선택한다. 두 스킬을 동시에 invoke하면 operating rule이 충돌하고 output 형식이 섞인다.
  3. UI 보충 참조 — 다른 스킬 실행 중 웹 앱 UI 경로 안내가 필요하면 vox-web-app을 secondary로 참조한다. UI 경로와 딥링크는 자주 변경되므로 web-app의 references가 정확한 경로를 가지고 있다.

Routing Disambiguation

경계가 모호한 케이스의 판단 기준:

| 요청 패턴 | 라우팅 | 이유 | |-----------|--------|------| | 프롬프트 안에서 도구 호출 방법 언급 | vox-agents | 프롬프트 컨텍스트 안의 도구 언급은 prompt authoring | | 도구 자체의 생성/삭제/파라미터 변경 | vox-tools | 도구 CRUD는 tools 영역 | | 대시보드에서 TTS/속도/설정 변경 | vox-web-app | UI 조작 가이드는 웹 앱 영역 | | "에이전트 만들어줘" (첫 사용자/MCP 미연결) | vox-onboarding | 온보딩 플로우에 에이전트 생성 포함 | | "에이전트 만들어줘" (기존 사용자) | vox-agents | 온보딩 이후의 에이전트 생성은 authoring | | "flow 설계해줘", "스크립트를 노드로 변환" | vox-flow | flow 전용 설계 작업 | | "flow vs single prompt 뭐가 나아?" | vox-agents | 유형 판단은 agents가 소유, flow 결정 시 handoff | | 요금/빌링/플랜/크레딧 질문 | docs MCP | 실시간 pricing 페이지 검색 | | SDK 사용법, API reference | docs MCP | 문서 검색으로 충분 | | "캠페인 만들어줘", "대량발신 설정" | vox-web-app | 대량발신/캠페인 관리는 웹 앱 영역 | | "번호 구매 페이지 알려줘", "녹취 어디서 들어?" | vox-web-app | 페이지 경로/딥링크 안내 | | 어떤 스킬에도 매핑 안 되는 vox.ai 질문 | docs MCP → vox-onboarding | docs 검색 먼저, 없으면 onboarding이 가장 넓은 안내 범위 |

복합 요청

"프롬프트 작성 + 도구 연결"처럼 여러 영역에 걸친 요청은:

  1. 핵심 작업을 primary skill로 선택 (요청의 주된 의도)
  2. primary 완료 후 "도구 연결도 진행할까요?"로 secondary handoff
  3. 동시 invoke하지 않는다 — 한 스킬의 output이 다음 스킬의 input이 되는 경우가 많다

이 스킬이 하지 않는 것

domain skill의 내용을 복제하거나 요약하지 않는다 — router가 domain 내용을 요약하면 domain skill 업데이트 시 불일치가 발생한다. 각 domain skill이 소유하는 영역은 위 Skill Catalog 참조.