SKILL.md que um agente LLM carrega sob demanda para trabalhar corretamente contra uma área específica da API.
GitHub: veniceai/skills
19 skills cobrindo a API Venice completa. Licença MIT. Mantida em sincronia com o
swagger.yaml público.19 skills
Uma por área da API Venice
Agnóstico de runtime
Funciona com Claude Code, Cursor, Codex, OpenCode, Hermes, Cline e qualquer outro host de Agent Skills
Sincronizado com a spec
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 umSKILL.md que começa com frontmatter YAML:
skills/ (ou qualquer subconjunto) no caminho que seu runtime observa.
- Claude Code
- Cursor
- Codex
- OpenCode
- Hermes Agent
- Cline
Local do projeto:Ou global, para todo projeto na sua máquina:
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/ |
Como submódulo git
Se você quiser versões fixadas no seu próprio repo:Como os agentes os carregam
O agente descobre cadaSKILL.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/quotepara estimativa de custo primeiro - Como deve ser o backoff de polling
/audio/speech para música e obter uma resposta inútil.
Criando uma nova skill
- Copie
template/paraskills/<your-skill>/. - Preencha o frontmatter e o corpo. Mantenha
descriptionconcreto, já que é o que um agente usa para decidir quando carregar a skill. - Vincule skills relacionadas no final para navegação cruzada.
- Abra um PR contra
veniceai/skills.
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
GitHub
Código-fonte, guia de contribuição e template de skill
Venice MCP Server
Combine skills com o servidor MCP oficial para acesso a ferramentas em runtime
Spec do Agent Skills
Aprenda o formato subjacente
Spec da API Venice
A fonte da verdade OpenAPI da qual essas skills são derivadas