Vai al contenuto principale
Venice Skills è la raccolta canonica di Agent Skills per l’API Venice. Ogni skill è una cartella autonoma con un SKILL.md che un agente LLM carica su richiesta per lavorare correttamente con una specifica area dell’API.

GitHub: veniceai/skills

19 skill che coprono l’intera API Venice. Licenza MIT. Sincronizzate con il swagger.yaml pubblico.

19 skill

Una per ogni area dell’API Venice

Indipendente dal runtime

Funziona con Claude Code, Cursor, Codex, OpenCode, Hermes, Cline e qualsiasi altro host di Agent Skills

Sincronizzate con la spec

Derivate dalla spec OpenAPI di Venice, con controlli CI per i drift

​
Perché le skill?

Senza skill, il tuo agente deve scoprire le peculiarità di Venice nel modo più difficile: venice_parameters, enum di tipi di modello, flussi 402 payment-required, ciclo di vita queue/retrieve dei video, slug dei personaggi e così via. Le skill raggruppano queste conoscenze in file mirati e su richiesta, in modo che l’agente carichi solo ciò che gli serve per il compito attuale. Ogni SKILL.md include:
  • L’endpoint o gli endpoint che copre
  • Header, parametri e forme della risposta richiesti
  • Un esempio curl più un esempio SDK minimale
  • Una sezione “gotcha” con le cose su cui gli integratori reali inciampano

​
Catalogo delle skill

SkillCopre
venice-api-overviewBase URL, modalità di autenticazione, header di risposta, modello di prezzo, versioning
venice-authBearer API key + autenticazione wallet Sign-In-With-X / x402
venice-chat/chat/completions con venice_parameters, multimodale, tool, ragionamento, streaming
venice-responses/responses, l’API Responses compatibile con OpenAI (Alpha)
venice-embeddingsModelli /embeddings, encoding format, dimensioni
venice-image-generate/image/generate, /images/generations, /image/styles
venice-image-edit/image/edit, /image/multi-edit, /image/upscale, /image/background-remove
venice-audio-speechModelli TTS /audio/speech, voci, formati, streaming
venice-audio-music/audio/quote, /audio/queue, /audio/retrieve, /audio/complete
venice-audio-transcription/audio/transcriptions con Whisper, Parakeet, Scribe, Wizper, xAI STT
venice-videoGenerazione + trascrizione /video/*
venice-models/models, /models/traits, /models/compatibility_mapping
venice-characters/characters* + venice_parameters.character_slug
venice-api-keysCRUD /api_keys, rate limit, generazione di Web3 key
venice-billing/billing/balance, /billing/usage, /billing/usage-analytics
venice-x402Crediti wallet /x402/*, USDC su Base o Solana
venice-crypto-rpcProxy JSON-RPC /crypto/rpc/* con prezzi 1×/2×/4×
venice-augment/augment/text-parser, /augment/scrape, /augment/search
venice-errorsForme degli errori, 402 payment required, 422 content policy, 429 rate limit, strategie di retry

​
Installazione

Ogni skill è semplicemente una cartella con un SKILL.md che inizia con un frontmatter YAML: 
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
Trascina la cartella skills/ (o un suo sottoinsieme) nel percorso che il tuo runtime monitora.
A livello di progetto:
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
Oppure globale, per ogni progetto sulla tua macchina:
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

​
Riferimento dei percorsi

RuntimeA livello di progettoGlobale
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/ (oppure $CODEX_HOME/skills/)
OpenCode.opencode/skills/ (anche .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
Altri runtime.agents/skills/ (convenzione)~/.agents/skills/
I runtime che definiscono campi di frontmatter extra (version, platforms, metadata.*, compatibility, …) sono tenuti dalla specifica a ignorare i campi sconosciuti, quindi lo stesso file di skill funziona ovunque senza fork.

​
Come git submodule

Se vuoi versioni fissate nel tuo repo: 
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
Quindi crea symlink o copia i sottoinsiemi che vuoi nel percorso delle skill del tuo agente.

​
Come gli agenti le caricano

L’agente scopre ciascun SKILL.md tramite name e description nel frontmatter. Quando l’utente chiede qualcosa che corrisponde allo scopo di una skill, l’agente carica quel singolo file nel contesto (non l’intero catalogo), in modo che il prompt rimanga piccolo e la risposta rimanga accurata. Ad esempio, un agente che deve generare musica caricherà venice-audio-music e saprà immediatamente:
  • Che la musica passa per il ciclo di vita queue/retrieve/complete, non per un endpoint sincrono
  • Quali modelli sono disponibili e i loro prezzi al minuto
  • Come chiamare prima /audio/quote per la stima dei costi
  • Come dovrebbe essere il backoff del polling
Senza la skill, l’agente potrebbe provare a chiamare /audio/speech per la musica e ottenere una risposta inutile.

​
Scrivere una nuova skill

  1. Copia template/ in skills/<your-skill>/.
  2. Compila il frontmatter e il body. Mantieni description concreta, perché è ciò che un agente usa per decidere quando caricare la skill.
  3. Collega le skill correlate in fondo per la navigazione incrociata.
  4. Apri una PR su veniceai/skills.
Consulta il CONTRIBUTING.md del repository per le convenzioni di stile (primo paragrafo breve, tabelle di endpoint esplicite, esempio curl + un esempio SDK, sezione “gotcha”, ≤ 500 righe).

​
Risorse

GitHub

Codice sorgente, guida ai contributi e template di skill

Server MCP di Venice

Affianca le skill al server MCP ufficiale per l’accesso a runtime tool

Specifica Agent Skills

Scopri il formato sottostante

Specifica API Venice

La sorgente di verità OpenAPI da cui derivano queste skill