> ## 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 > Venice Agent Skills ufficiali che insegnano agli agenti di coding come Claude Code, Cursor, Codex, OpenCode e Hermes a chiamare Venice correttamente. [Venice Skills](https://github.com/veniceai/skills) è la raccolta canonica di [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) 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. 19 skill che coprono l'intera API Venice. Licenza MIT. Sincronizzate con il [`swagger.yaml`](/api-reference/api-spec) pubblico. Una per ogni area dell'API Venice Funziona con Claude Code, Cursor, Codex, OpenCode, Hermes, Cline e qualsiasi altro host di Agent Skills 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 | Skill | Copre | | ---------------------------- | ------------------------------------------------------------------------------------------------ | | `venice-api-overview` | Base URL, modalità di autenticazione, header di risposta, modello di prezzo, versioning | | `venice-auth` | Bearer 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-embeddings` | Modelli `/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-speech` | Modelli 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-video` | Generazione + trascrizione `/video/*` | | `venice-models` | `/models`, `/models/traits`, `/models/compatibility_mapping` | | `venice-characters` | `/characters*` + `venice_parameters.character_slug` | | `venice-api-keys` | CRUD `/api_keys`, rate limit, generazione di Web3 key | | `venice-billing` | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics` | | `venice-x402` | Crediti wallet `/x402/*`, USDC su Base o Solana | | `venice-crypto-rpc` | Proxy JSON-RPC `/crypto/rpc/*` con prezzi 1×/2×/4× | | `venice-augment` | `/augment/text-parser`, `/augment/scrape`, `/augment/search` | | `venice-errors` | Forme 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: ```yaml theme={"system"} --- 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: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git cp -r skills/skills/* .claude/skills/ ``` Oppure globale, per ogni progetto sulla tua macchina: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git ~/src/venice-skills ln -s ~/src/venice-skills/skills ~/.claude/skills/venice ``` A livello di progetto: ```bash theme={"system"} git clone https://github.com/veniceai/skills.git .cursor/skills-venice ``` Oppure copia singole skill: ```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 ``` Per installazioni a livello di progetto, usa invece `.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 ``` OpenCode legge anche `.opencode/skills/`, `.claude/skills/` e `.agents/skills/` dalla root del progetto. Hermes ha un installer integrato per le skill Venice: ```bash theme={"system"} hermes skills install veniceai/skills ``` Oppure crea un symlink diretto: ```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 ``` ### Riferimento dei percorsi | Runtime | A livello di progetto | Globale | | ------------- | ---------------------------------------------------------------- | ------------------------------------------------- | | 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: ```bash theme={"system"} 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//`. 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`](https://github.com/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 Codice sorgente, guida ai contributi e template di skill Affianca le skill al server MCP ufficiale per l'accesso a runtime tool Scopri il formato sottostante La sorgente di verità OpenAPI da cui derivano queste skill