Pular para o conteúdo principal
Venice Skills é a coleção canônica de Agent Skills 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.

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

SkillCobre
venice-api-overviewBase URL, modos de auth, cabeçalhos de resposta, modelo de preços, versionamento
venice-authBearer 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-embeddingsModelos 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-speechModelos 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-videoGeração + transcrição em /video/*
venice-models/models, /models/traits, /models/compatibility_mapping
venice-characters/characters* + venice_parameters.character_slug
venice-api-keysCRUD 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-errorsFormatos 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:
---
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:
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
Ou global, para todo projeto na sua máquina:
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

Referência de caminhos

RuntimeLocal do projetoGlobal
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:
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/<your-skill>/.
  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.
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

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