SKILL.md qu’un agent LLM charge à la demande pour fonctionner correctement avec une surface spécifique de l’API.
GitHub : veniceai/skills
19 skills couvrant l’API Venice complète. Sous licence MIT. Maintenu synchronisé avec le
swagger.yaml public.19 skills
Un par surface d’API Venice
Indépendant du runtime
Fonctionne avec Claude Code, Cursor, Codex, OpenCode, Hermes, Cline et tout autre hôte d’Agent Skills
Synchronisé avec la spec
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 unSKILL.md qui commence par un frontmatter YAML :
skills/ (ou tout sous-ensemble) dans le chemin que votre runtime surveille.
- Claude Code
- Cursor
- Codex
- OpenCode
- Hermes Agent
- Cline
Local au projet :Ou global, pour chaque projet sur votre machine :
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/ |
En tant que sous-module git
Si vous voulez des versions épinglées dans votre propre repo :Comment les agents les chargent
L’agent découvre chaqueSKILL.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/quotepour estimer d’abord le coût - À quoi devrait ressembler le backoff de polling
/audio/speech pour de la musique et obtenir une réponse inutile.
Créer un nouveau skill
- Copiez
template/versskills/<your-skill>/. - Remplissez le frontmatter et le corps. Gardez
descriptionconcret, car c’est ce qu’un agent utilise pour décider quand charger le skill. - Liez les skills associés en bas pour la navigation croisée.
- Ouvrez une PR sur
veniceai/skills.
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
GitHub
Code source, guide de contribution et template de skill
Serveur MCP Venice
Associez les skills au serveur MCP officiel pour l’accès aux outils runtime
Spec Agent Skills
Apprenez le format sous-jacent
Spec API Venice
La source de vérité OpenAPI dont ces skills sont dérivés