> ## 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 > Skills d'agent Venice officiels qui chargent la connaissance des endpoints dans Claude Code, Cursor, Codex, OpenCode, Hermes et Cline. [Venice Skills](https://github.com/veniceai/skills) est la collection canonique de [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) pour l'API Venice. Chaque skill est un dossier autonome avec un fichier `SKILL.md` qu'un agent LLM charge à la demande pour fonctionner correctement avec une surface spécifique de l'API. 19 skills couvrant l'API Venice complète. Sous licence MIT. Maintenu synchronisé avec le [`swagger.yaml`](/api-reference/api-spec) public. Un par surface d'API Venice Fonctionne avec Claude Code, Cursor, Codex, OpenCode, Hermes, Cline et tout autre hôte d'Agent Skills Dérivé de la spec OpenAPI de Venice, avec vérifications CI pour la dérive ## Pourquoi des skills ? Sans skills, votre agent doit découvrir les particularités de Venice à la dure : `venice_parameters`, énumérations de types de modèles, flux 402 paiement requis, cycle de vie queue/retrieve vidéo, slugs de personnage, etc. Les skills regroupent ces connaissances dans des fichiers ciblés et à la demande pour que l'agent ne charge que ce dont il a besoin pour la tâche courante. Chaque `SKILL.md` inclut : * Le ou les endpoints qu'il couvre * En-têtes, paramètres et formes de réponse requis * Un exemple curl plus un exemple minimal de SDK * Une section « gotchas » avec les points sur lesquels les intégrateurs réels trébuchent ## Catalogue de skills | Skill | Couvre | | ---------------------------- | ---------------------------------------------------------------------------------------------------------- | | `venice-api-overview` | URL de base, modes d'auth, en-têtes de réponse, modèle de tarification, versioning | | `venice-auth` | Clés API Bearer + authentification Sign-In-With-X / portefeuille x402 | | `venice-chat` | `/chat/completions` avec `venice_parameters`, multimodal, outils, raisonnement, streaming | | `venice-responses` | `/responses`, l'API Responses compatible OpenAI (Alpha) | | `venice-embeddings` | Modèles `/embeddings`, formats d'encodage, dimensions | | `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` | Modèles TTS `/audio/speech`, voix, formats, streaming | | `venice-audio-music` | `/audio/quote`, `/audio/queue`, `/audio/retrieve`, `/audio/complete` | | `venice-audio-transcription` | `/audio/transcriptions` avec Whisper, Parakeet, Scribe, Wizper, xAI STT | | `venice-video` | Génération `/video/*` + transcription | | `venice-models` | `/models`, `/models/traits`, `/models/compatibility_mapping` | | `venice-characters` | `/characters*` + `venice_parameters.character_slug` | | `venice-api-keys` | CRUD `/api_keys`, limites de débit, génération de clé Web3 | | `venice-billing` | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics` | | `venice-x402` | Crédits de portefeuille `/x402/*`, USDC sur Base ou Solana | | `venice-crypto-rpc` | Proxy JSON-RPC `/crypto/rpc/*` avec tarification 1×/2×/4× | | `venice-augment` | `/augment/text-parser`, `/augment/scrape`, `/augment/search` | | `venice-errors` | Formes d'erreur, 402 paiement requis, 422 politique de contenu, 429 limites de débit, stratégie de relance | ## Installation Chaque skill est juste un dossier avec un `SKILL.md` qui commence par un frontmatter YAML : ```yaml theme={"system"} --- name: venice-chat description: When the agent should load this skill and what's in it --- ``` Déposez le dossier `skills/` (ou tout sous-ensemble) dans le chemin que votre runtime surveille. Local au projet : ```bash theme={"system"} git clone https://github.com/veniceai/skills.git cp -r skills/skills/* .claude/skills/ ``` Ou global, pour chaque projet sur votre machine : ```bash theme={"system"} git clone https://github.com/veniceai/skills.git ~/src/venice-skills ln -s ~/src/venice-skills/skills ~/.claude/skills/venice ``` Local au projet : ```bash theme={"system"} git clone https://github.com/veniceai/skills.git .cursor/skills-venice ``` Ou copiez des skills individuels : ```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 ``` Pour les installations locales au projet, ciblez plutôt `.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 lit également `.opencode/skills/`, `.claude/skills/` et `.agents/skills/` depuis la racine du projet. Hermes dispose d'un installateur intégré pour les skills Venice : ```bash theme={"system"} hermes skills install veniceai/skills ``` Ou faites un lien symbolique directement : ```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 ``` ### Référence des chemins | Runtime | Local au projet | Global | | --------------- | ---------------------------------------------------------------- | --------------------------------------------- | | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Codex | `.codex/skills/` | `~/.codex/skills/` (ou `$CODEX_HOME/skills/`) | | OpenCode | `.opencode/skills/` (aussi `.claude/skills/`, `.agents/skills/`) | `~/.config/opencode/skills/` | | Hermes Agent | `$HERMES_OPTIONAL_SKILLS_DIR` | `~/.hermes/skills/` | | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | | Cline | `.clinerules/skills/` | n/a | | Autres runtimes | `.agents/skills/` (convention) | `~/.agents/skills/` | Les runtimes qui définissent des champs de frontmatter supplémentaires (`version`, `platforms`, `metadata.*`, `compatibility`, …) sont tenus par la spec d'ignorer les champs inconnus, donc le même fichier de skill fonctionne partout sans fork. ### En tant que sous-module git Si vous voulez des versions épinglées dans votre propre repo : ```bash theme={"system"} git submodule add https://github.com/veniceai/skills.git vendor/venice-skills ``` Puis liez symboliquement ou copiez les sous-ensembles que vous voulez dans le chemin de skills de votre agent. ## Comment les agents les chargent L'agent découvre chaque `SKILL.md` par son `name` et sa `description` de frontmatter. Lorsque l'utilisateur demande quelque chose qui correspond à l'objectif d'un skill, l'agent charge ce fichier unique en contexte (et non le catalogue entier), pour que le prompt reste petit et la réponse précise. Par exemple, un agent qui a besoin de générer de la musique chargera `venice-audio-music` et saura immédiatement : * Que la musique passe par le cycle de vie queue/retrieve/complete, et non par un endpoint synchrone * Quels modèles sont disponibles et leur tarification par minute * Comment appeler `/audio/quote` pour estimer d'abord le coût * À quoi devrait ressembler le backoff de polling Sans le skill, l'agent pourrait essayer d'appeler `/audio/speech` pour de la musique et obtenir une réponse inutile. ## Créer un nouveau skill 1. Copiez `template/` vers `skills//`. 2. Remplissez le frontmatter et le corps. Gardez `description` concret, car c'est ce qu'un agent utilise pour décider quand charger le skill. 3. Liez les skills associés en bas pour la navigation croisée. 4. Ouvrez une PR sur [`veniceai/skills`](https://github.com/veniceai/skills). Voir le `CONTRIBUTING.md` du dépôt pour les conventions de style (premier paragraphe court, tableaux d'endpoints explicites, exemple curl + un SDK, section « gotchas », ≤ 500 lignes). ## Ressources Code source, guide de contribution et template de skill Associez les skills au serveur MCP officiel pour l'accès aux outils runtime Apprenez le format sous-jacent La source de vérité OpenAPI dont ces skills sont dérivés