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

​
Instalação

Cada skill é apenas uma pasta com um SKILL.md que começa com frontmatter YAML:
Coloque a pasta skills/ (ou qualquer subconjunto) no caminho que seu runtime observa.
Local do projeto:
Ou global, para todo projeto na sua máquina:

​
Referência de caminhos

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:
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