> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Venice Skills
> Claude Code, Cursor, Codex, OpenCode, Hermes, Cline에 엔드포인트 지식을 로드해 코딩 에이전트가 Venice를 정확히 호출하도록 돕는 공식 Venice Agent Skills.
[Venice Skills](https://github.com/veniceai/skills)는 Venice API를 위한 [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)의 표준 모음입니다. 각 스킬은 LLM 에이전트가 API의 특정 영역에서 올바르게 작동하기 위해 필요할 때 로드하는 `SKILL.md`가 포함된 자체 완결 폴더입니다.
Venice API 전체를 다루는 19개 스킬. MIT 라이선스. 공개 [`swagger.yaml`](/api-reference/api-spec)과 동기화 유지.
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" 섹션
## 스킬 카탈로그
| Skill | Covers |
| ---------------------------- | -------------------------------------------------------------------------------- |
| `venice-api-overview` | Base URL, 인증 모드, 응답 헤더, 가격 모델, 버전 관리 |
| `venice-auth` | Bearer API 키 + Sign-In-With-X / x402 지갑 인증 |
| `venice-chat` | `venice_parameters`, 멀티모달, 도구, 추론, 스트리밍과 함께 `/chat/completions` |
| `venice-responses` | OpenAI 호환 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-transcription` | Whisper, 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-rpc` | 1×/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`를 가진 폴더일 뿐입니다:
```yaml theme={"system"}
---
name: venice-chat
description: 에이전트가 이 스킬을 언제 로드해야 하는지와 그 안에 무엇이 있는지
---
```
`skills/` 폴더(또는 일부)를 런타임이 감시하는 경로 아무 곳에나 놓으세요.
프로젝트 로컬:
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
```
또는 머신 내 모든 프로젝트를 위한 글로벌:
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice
```
프로젝트 로컬:
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git .cursor/skills-venice
```
또는 개별 스킬 복사:
```bash theme={"system"}
cp -r skills/venice-chat .cursor/skills/
```
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.codex/skills/venice
```
프로젝트 로컬 설치는 대신 `.codex/skills/`를 사용하세요.
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.config/opencode/skills/venice
```
OpenCode는 프로젝트 루트에서 `.opencode/skills/`, `.claude/skills/`, `.agents/skills/`도 읽습니다.
Hermes에는 Venice 스킬용 내장 설치 도구가 있습니다:
```bash theme={"system"}
hermes skills install veniceai/skills
```
또는 직접 심볼릭 링크를 만드세요:
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.hermes/skills/venice
```
```bash theme={"system"}
git clone https://github.com/veniceai/skills.git .clinerules/skills-venice
```
### 경로 참고
| Runtime | Project-local | Global |
| ------------ | --------------------------------------------------------------- | --------------------------------------------- |
| 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 서브모듈로 사용
자체 레포에 핀된 버전을 두고 싶다면:
```bash theme={"system"}
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//`로 복사.
2. frontmatter와 본문을 채우세요. 에이전트가 언제 이 스킬을 로드할지 결정하는 단서이므로 `description`을 구체적으로 작성하세요.
3. 교차 탐색을 위해 하단에 관련 스킬을 링크하세요.
4. [`veniceai/skills`](https://github.com/veniceai/skills)에 PR을 여세요.
스타일 관례(짧은 첫 문단, 명시적 endpoint 표, curl + SDK 예시 하나, "gotchas" 섹션, 500줄 이하)는 저장소의 `CONTRIBUTING.md`를 참고하세요.
## 리소스
소스 코드, 기여 가이드, 스킬 템플릿
런타임 도구 접근을 위해 스킬을 공식 MCP 서버와 함께 사용
기반이 되는 포맷 알아보기
이 스킬들이 파생된 OpenAPI 진실의 원천