> ## 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 > Agent Skills oficiais da Venice que carregam conhecimento dos endpoints em Claude Code, Cursor, Codex, OpenCode, Hermes e Cline para chamadas corretas. [Venice Skills](https://github.com/veniceai/skills) é a coleção canônica de [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) para a API Venice. Cada skill é uma pasta autocontida com um `SKILL.md` que um agente LLM carrega sob demanda para trabalhar corretamente contra uma área específica da API. 19 skills cobrindo a API Venice completa. Licença MIT. Mantida em sincronia com o [`swagger.yaml`](/api-reference/api-spec) público. Uma por área da API Venice Funciona com Claude Code, Cursor, Codex, OpenCode, Hermes, Cline e qualquer outro host de Agent Skills Derivado da spec OpenAPI da Venice, com verificações de CI contra drift ## Por que skills? Sem skills, seu agente precisa descobrir as peculiaridades da Venice na marra: `venice_parameters`, enums de tipo de modelo, fluxos de pagamento 402, ciclo de vida queue/retrieve de vídeo, slugs de personagens e assim por diante. Skills empacotam esse conhecimento em arquivos focados, sob demanda, para que o agente só carregue o que precisa para a tarefa atual. Cada `SKILL.md` inclui: * O(s) endpoint(s) que ele cobre * Cabeçalhos, parâmetros e formatos de resposta necessários * Um exemplo em curl mais um exemplo mínimo de SDK * Uma seção "gotchas" com as coisas que integradores reais tropeçam ## Catálogo de skills | Skill | Cobre | | ---------------------------- | ------------------------------------------------------------------------------------------------------ | | `venice-api-overview` | Base URL, modos de auth, cabeçalhos de resposta, modelo de preços, versionamento | | `venice-auth` | Bearer API keys + autenticação Sign-In-With-X / x402 com carteira | | `venice-chat` | `/chat/completions` com `venice_parameters`, multimodal, ferramentas, reasoning, streaming | | `venice-responses` | `/responses`, a Responses API compatível com OpenAI (Alpha) | | `venice-embeddings` | Modelos de `/embeddings`, formatos de codificação, dimensões | | `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` | Modelos TTS, vozes, formatos e streaming de `/audio/speech` | | `venice-audio-music` | `/audio/quote`, `/audio/queue`, `/audio/retrieve`, `/audio/complete` | | `venice-audio-transcription` | `/audio/transcriptions` com Whisper, Parakeet, Scribe, Wizper, xAI STT | | `venice-video` | Geração + transcrição em `/video/*` | | `venice-models` | `/models`, `/models/traits`, `/models/compatibility_mapping` | | `venice-characters` | `/characters*` + `venice_parameters.character_slug` | | `venice-api-keys` | CRUD em `/api_keys`, limites de taxa, geração de chave Web3 | | `venice-billing` | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics` | | `venice-x402` | `/x402/*` créditos de carteira, USDC na Base ou Solana | | `venice-crypto-rpc` | `/crypto/rpc/*` proxy JSON-RPC com preço 1×/2×/4× | | `venice-augment` | `/augment/text-parser`, `/augment/scrape`, `/augment/search` | | `venice-errors` | Formatos de erro, 402 payment required, 422 política de conteúdo, 429 rate limits, estratégia de retry | ## Instalação Cada skill é apenas uma pasta com um `SKILL.md` que começa com frontmatter YAML: ```yaml theme={"system"} --- name: venice-chat description: When the agent should load this skill and what's in it --- ``` Coloque a pasta `skills/` (ou qualquer subconjunto) no caminho que seu runtime observa. Local do projeto: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git cp -r skills/skills/* .claude/skills/ ``` Ou global, para todo projeto na sua máquina: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git ~/src/venice-skills ln -s ~/src/venice-skills/skills ~/.claude/skills/venice ``` Local do projeto: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git .cursor/skills-venice ``` Ou copie skills individuais: ```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 ``` Para instalações locais do projeto, mire em `.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 ``` O OpenCode também lê `.opencode/skills/`, `.claude/skills/` e `.agents/skills/` a partir da raiz do projeto. O Hermes tem um instalador integrado para skills da Venice: ```bash theme={"system"} hermes skills install veniceai/skills ``` Ou faça symlink diretamente: ```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 ``` ### Referência de caminhos | Runtime | Local do projeto | Global | | --------------- | ----------------------------------------------------------------- | --------------------------------------------- | | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Codex | `.codex/skills/` | `~/.codex/skills/` (ou `$CODEX_HOME/skills/`) | | OpenCode | `.opencode/skills/` (também `.claude/skills/`, `.agents/skills/`) | `~/.config/opencode/skills/` | | Hermes Agent | `$HERMES_OPTIONAL_SKILLS_DIR` | `~/.hermes/skills/` | | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | | Cline | `.clinerules/skills/` | n/d | | Outros runtimes | `.agents/skills/` (convenção) | `~/.agents/skills/` | Runtimes que definem campos de frontmatter extras (`version`, `platforms`, `metadata.*`, `compatibility`, …) são obrigados pela spec a ignorar campos desconhecidos, então o mesmo arquivo de skill funciona em todos os lugares sem forks. ### Como submódulo git Se você quiser versões fixadas no seu próprio repo: ```bash theme={"system"} git submodule add https://github.com/veniceai/skills.git vendor/venice-skills ``` Depois, faça symlink ou copie os subconjuntos que você quer no caminho de skill do seu agente. ## Como os agentes os carregam O agente descobre cada `SKILL.md` pelos campos `name` e `description` no frontmatter. Quando o usuário pede algo que combina com o propósito de uma skill, o agente carrega aquele único arquivo no contexto (não o catálogo inteiro), então o prompt permanece pequeno e a resposta permanece precisa. Por exemplo, um agente que precisa gerar música carregará `venice-audio-music` e imediatamente saberá: * Que música passa pelo ciclo queue/retrieve/complete, não por um endpoint síncrono * Quais modelos estão disponíveis e seus preços por minuto * Como chamar `/audio/quote` para estimativa de custo primeiro * Como deve ser o backoff de polling Sem a skill, o agente poderia tentar chamar `/audio/speech` para música e obter uma resposta inútil. ## Criando uma nova skill 1. Copie `template/` para `skills//`. 2. Preencha o frontmatter e o corpo. Mantenha `description` concreto, já que é o que um agente usa para decidir quando carregar a skill. 3. Vincule skills relacionadas no final para navegação cruzada. 4. Abra um PR contra [`veniceai/skills`](https://github.com/veniceai/skills). Veja o `CONTRIBUTING.md` do repositório para convenções de estilo (primeiro parágrafo curto, tabelas explícitas de endpoints, curl + um exemplo de SDK, seção "gotchas", ≤ 500 linhas). ## Recursos Código-fonte, guia de contribuição e template de skill Combine skills com o servidor MCP oficial para acesso a ferramentas em runtime Aprenda o formato subjacente A fonte da verdade OpenAPI da qual essas skills são derivadas