메인 콘텐츠로 건너뛰기
Venice Skills는 Venice API를 위한 Agent Skills의 표준 모음입니다. 각 스킬은 LLM 에이전트가 API의 특정 영역에서 올바르게 작동하기 위해 필요할 때 로드하는 SKILL.md가 포함된 자체 완결 폴더입니다.

GitHub: veniceai/skills

Venice API 전체를 다루는 19개 스킬. MIT 라이선스. 공개 swagger.yaml과 동기화 유지.

19개 스킬

Venice API 영역별 하나씩

런타임 독립적

Claude Code, Cursor, Codex, OpenCode, Hermes, Cline 등 모든 Agent Skills 호스트와 호환

스펙 동기화

Venice의 OpenAPI 스펙에서 파생되며, drift 검사 CI 포함

​
왜 스킬인가요?

스킬이 없으면 에이전트는 venice_parameters, 모델 타입 enum, 402 결제 필요 흐름, 비디오 큐/조회 생명주기, 캐릭터 slug 등 Venice의 특이사항을 어렵게 발견해야 합니다. 스킬은 그 지식을 집중되고 필요 시 로드되는 파일로 묶어, 에이전트가 현재 작업에 필요한 것만 로드하도록 합니다. 각 SKILL.md에는 다음이 포함됩니다:
  • 다루는 endpoint
  • 필요한 헤더, 파라미터, 응답 형태
  • curl 예시와 최소 SDK 예시
  • 실제 통합 시 자주 걸려 넘어지는 부분을 다루는 “gotchas” 섹션

​
스킬 카탈로그

SkillCovers
venice-api-overviewBase URL, 인증 모드, 응답 헤더, 가격 모델, 버전 관리
venice-authBearer API 키 + Sign-In-With-X / x402 지갑 인증
venice-chatvenice_parameters, 멀티모달, 도구, 추론, 스트리밍과 함께 /chat/completions
venice-responsesOpenAI 호환 Responses API(Alpha)인 /responses
venice-embeddings/embeddings 모델, 인코딩 포맷, 차원
venice-image-generate/image/generate, /images/generations, /image/styles
venice-image-edit/image/edit, /image/multi-edit, /image/upscale, /image/background-remove
venice-audio-speech/audio/speech TTS 모델, 음성, 포맷, 스트리밍
venice-audio-music/audio/quote, /audio/queue, /audio/retrieve, /audio/complete
venice-audio-transcriptionWhisper, Parakeet, Scribe, Wizper, xAI STT와 함께 /audio/transcriptions
venice-video/video/* 생성 + 전사
venice-models/models, /models/traits, /models/compatibility_mapping
venice-characters/characters* + venice_parameters.character_slug
venice-api-keys/api_keys CRUD, rate limit, Web3 키 생성
venice-billing/billing/balance, /billing/usage, /billing/usage-analytics
venice-x402/x402/* 지갑 크레딧, Base 또는 Solana의 USDC
venice-crypto-rpc1×/2×/4× 가격의 /crypto/rpc/* JSON-RPC 프록시
venice-augment/augment/text-parser, /augment/scrape, /augment/search
venice-errors에러 형태, 402 결제 필요, 422 콘텐츠 정책, 429 rate limit, 재시도 전략

​
설치

각 스킬은 YAML frontmatter로 시작하는 SKILL.md를 가진 폴더일 뿐입니다: 
---
name: venice-chat
description: 에이전트가 이 스킬을 언제 로드해야 하는지와 그 안에 무엇이 있는지
---
skills/ 폴더(또는 일부)를 런타임이 감시하는 경로 아무 곳에나 놓으세요.
프로젝트 로컬:
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
또는 머신 내 모든 프로젝트를 위한 글로벌:
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

​
경로 참고

RuntimeProject-localGlobal
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/ (또는 $CODEX_HOME/skills/)
OpenCode.opencode/skills/ ( .claude/skills/, .agents/skills/도 가능)~/.config/opencode/skills/
Hermes Agent$HERMES_OPTIONAL_SKILLS_DIR~/.hermes/skills/
Cursor.cursor/skills/~/.cursor/skills/
Cline.clinerules/skills/n/a
기타 런타임.agents/skills/ (관례)~/.agents/skills/
추가 frontmatter 필드(version, platforms, metadata.*, compatibility 등)를 정의하는 런타임은 알 수 없는 필드를 무시하도록 스펙으로 정해져 있으므로, 같은 스킬 파일이 어디서나 fork 없이 동작합니다.

​
Git 서브모듈로 사용

자체 레포에 핀된 버전을 두고 싶다면: 
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
그런 다음 원하는 부분만 에이전트의 스킬 경로로 심볼릭 링크하거나 복사하세요.

​
에이전트가 어떻게 로드하나요

에이전트는 각 SKILL.md를 frontmatter의 name과 description으로 발견합니다. 사용자가 스킬의 목적과 맞는 무언가를 요청하면, 에이전트는 전체 카탈로그가 아니라 그 파일 하나만 context에 로드해 prompt를 작게 유지하고 답변의 정확성을 유지합니다. 예를 들어 음악을 생성해야 하는 에이전트는 venice-audio-music을 로드해 다음을 즉시 알게 됩니다:
  • 음악은 동기 endpoint가 아니라 큐/조회/완료 생명주기를 거친다는 점
  • 어떤 모델이 있고 분당 가격이 얼마인지
  • 비용 추정을 위해 /audio/quote를 먼저 호출하는 방법
  • 폴링 백오프가 어떤 모습이어야 하는지
스킬이 없다면 에이전트는 음악을 위해 /audio/speech를 호출하려 시도하고 쓸모없는 응답을 받게 될 수 있습니다.

​
새 스킬 작성

  1. template/을 skills/<your-skill>/로 복사.
  2. frontmatter와 본문을 채우세요. 에이전트가 언제 이 스킬을 로드할지 결정하는 단서이므로 description을 구체적으로 작성하세요.
  3. 교차 탐색을 위해 하단에 관련 스킬을 링크하세요.
  4. veniceai/skills에 PR을 여세요.
스타일 관례(짧은 첫 문단, 명시적 endpoint 표, curl + SDK 예시 하나, “gotchas” 섹션, 500줄 이하)는 저장소의 CONTRIBUTING.md를 참고하세요.

​
리소스

GitHub

소스 코드, 기여 가이드, 스킬 템플릿

Venice MCP 서버

런타임 도구 접근을 위해 스킬을 공식 MCP 서버와 함께 사용

Agent Skills 스펙

기반이 되는 포맷 알아보기

Venice API 스펙

이 스킬들이 파생된 OpenAPI 진실의 원천