Saltar al contenido principal
Venice Skills es la colección canónica de Agent Skills para la API de Venice. Cada skill es una carpeta autocontenida con un SKILL.md que un agente LLM carga bajo demanda para trabajar correctamente con un área específica de la API.

GitHub: veniceai/skills

19 skills que cubren toda la API de Venice. Licencia MIT. Sincronizadas con el swagger.yaml público.

19 Skills

Una por cada área de la API de Venice

Independiente del runtime

Funciona con Claude Code, Cursor, Codex, OpenCode, Hermes, Cline y cualquier otro host de Agent Skills

Sincronizadas con la spec

Derivadas de la especificación OpenAPI de Venice, con comprobaciones de CI ante desviaciones

​
¿Por qué skills?

Sin skills, tu agente tiene que descubrir las particularidades de Venice por las malas: venice_parameters, enums de tipo de modelo, flujos de pago 402, ciclo de vida queue/retrieve de vídeo, slugs de personaje, etc. Las skills empaquetan ese conocimiento en archivos enfocados y bajo demanda para que el agente solo cargue lo que necesita para la tarea actual. Cada SKILL.md incluye:
  • El o los endpoints que cubre
  • Cabeceras, parámetros y formas de respuesta requeridas
  • Un ejemplo en curl y un ejemplo mínimo en SDK
  • Una sección “gotchas” con los puntos en los que tropiezan los integradores reales

​
Catálogo de skills

SkillCubre
venice-api-overviewURL base, modos de auth, cabeceras de respuesta, modelo de precios, versionado
venice-authAPI keys Bearer + autenticación Sign-In-With-X / monedero x402
venice-chat/chat/completions con venice_parameters, multimodal, tools, razonamiento, streaming
venice-responses/responses, la API Responses compatible con OpenAI (Alpha)
venice-embeddingsModelos /embeddings, formatos de codificación, dimensiones
venice-image-generate/image/generate, /images/generations, /image/styles
venice-image-edit/image/edit, /image/multi-edit, /image/upscale, /image/background-remove
venice-audio-speechModelos TTS /audio/speech, voces, formatos, 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-videoGeneración + transcripción /video/*
venice-models/models, /models/traits, /models/compatibility_mapping
venice-characters/characters* + venice_parameters.character_slug
venice-api-keysCRUD /api_keys, rate limits, generación de claves Web3
venice-billing/billing/balance, /billing/usage, /billing/usage-analytics
venice-x402Créditos de monedero /x402/*, USDC en Base o Solana
venice-crypto-rpcProxy JSON-RPC /crypto/rpc/* con precios 1×/2×/4×
venice-augment/augment/text-parser, /augment/scrape, /augment/search
venice-errorsFormatos de error, 402 payment required, 422 política de contenido, 429 rate limits, estrategia de reintentos

​
Instalación

Cada skill es solo una carpeta con un SKILL.md que comienza con frontmatter YAML: 
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
Coloca la carpeta skills/ (o cualquier subconjunto) en la ruta que vigile tu runtime.
Local al proyecto:
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
O global, para cada proyecto en tu máquina:
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

​
Referencia de rutas

RuntimeLocal al proyectoGlobal
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/ (o $CODEX_HOME/skills/)
OpenCode.opencode/skills/ (también .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
Otros runtimes.agents/skills/ (convención)~/.agents/skills/
Los runtimes que definen campos de frontmatter adicionales (version, platforms, metadata.*, compatibility, …) deben, por especificación, ignorar campos desconocidos, por lo que el mismo archivo de skill funciona en todas partes sin forks.

​
Como submódulo de git

Si quieres versiones fijadas en tu propio repo: 
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
Luego enlaza o copia los subconjuntos que quieras en la ruta de skills de tu agente.

​
Cómo las cargan los agentes

El agente descubre cada SKILL.md por el name y la description de su frontmatter. Cuando el usuario pide algo que coincide con el propósito de una skill, el agente carga ese único archivo en contexto (no todo el catálogo), por lo que el prompt se mantiene pequeño y la respuesta precisa. Por ejemplo, un agente que necesita generar música cargará venice-audio-music y sabrá inmediatamente:
  • Que la música pasa por el ciclo de vida queue/retrieve/complete, no por un endpoint síncrono
  • Qué modelos están disponibles y su precio por minuto
  • Cómo llamar a /audio/quote primero para estimar el coste
  • Cómo debería ser el backoff de polling
Sin la skill, el agente podría intentar llamar a /audio/speech para música y obtener una respuesta inútil.

​
Crear una nueva skill

  1. Copia template/ a skills/<tu-skill>/.
  2. Rellena el frontmatter y el cuerpo. Mantén description concreta, ya que es lo que usa un agente para decidir cuándo cargar la skill.
  3. Enlaza skills relacionadas al final para navegación cruzada.
  4. Abre un PR contra veniceai/skills.
Consulta el CONTRIBUTING.md del repositorio para las convenciones de estilo (primer párrafo corto, tablas de endpoints explícitas, curl + un ejemplo de SDK, sección “gotchas”, ≤ 500 líneas).

​
Recursos

GitHub

Código fuente, guía de contribución y plantilla de skill

Venice MCP Server

Empareja skills con el servidor MCP oficial para acceso a herramientas en runtime

Spec de Agent Skills

Conoce el formato subyacente

Spec de la API de Venice

La especificación OpenAPI fuente de verdad de la que se derivan estas skills