Skip to main content
Venice Skills est la collection canonique de Agent Skills 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.

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

Installation

Chaque skill est juste un dossier avec un SKILL.md qui commence par un frontmatter YAML :
Déposez le dossier skills/ (ou tout sous-ensemble) dans le chemin que votre runtime surveille.
Local au projet :
Ou global, pour chaque projet sur votre machine :

Référence des chemins

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 :
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/<your-skill>/.
  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.
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

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