> ## 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

> Agent Skills oficiales de Venice que cargan el conocimiento de los endpoints en Claude Code, Cursor, Codex, OpenCode, Hermes y Cline.

[Venice Skills](https://github.com/veniceai/skills) es la colección canónica de [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) 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.

<Card title="GitHub: veniceai/skills" icon="github" href="https://github.com/veniceai/skills">
  19 skills que cubren toda la API de Venice. Licencia MIT. Sincronizadas con el [`swagger.yaml`](/api-reference/api-spec) público.
</Card>

<CardGroup cols={3}>
  <Card title="19 Skills" icon="layer-group">
    Una por cada área de la API de Venice
  </Card>

  <Card title="Independiente del runtime" icon="plug">
    Funciona con Claude Code, Cursor, Codex, OpenCode, Hermes, Cline y cualquier otro host de Agent Skills
  </Card>

  <Card title="Sincronizadas con la spec" icon="rotate">
    Derivadas de la especificación OpenAPI de Venice, con comprobaciones de CI ante desviaciones
  </Card>
</CardGroup>

## ¿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

| Skill                        | Cubre                                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `venice-api-overview`        | URL base, modos de auth, cabeceras de respuesta, modelo de precios, versionado                                |
| `venice-auth`                | API 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-embeddings`          | Modelos `/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-speech`        | Modelos 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-video`               | Generación + transcripción `/video/*`                                                                         |
| `venice-models`              | `/models`, `/models/traits`, `/models/compatibility_mapping`                                                  |
| `venice-characters`          | `/characters*` + `venice_parameters.character_slug`                                                           |
| `venice-api-keys`            | CRUD `/api_keys`, rate limits, generación de claves Web3                                                      |
| `venice-billing`             | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics`                                              |
| `venice-x402`                | Créditos de monedero `/x402/*`, USDC en Base o Solana                                                         |
| `venice-crypto-rpc`          | Proxy JSON-RPC `/crypto/rpc/*` con precios 1×/2×/4×                                                           |
| `venice-augment`             | `/augment/text-parser`, `/augment/scrape`, `/augment/search`                                                  |
| `venice-errors`              | Formatos 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:

```yaml theme={"system"}
---
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.

<Tabs>
  <Tab title="Claude Code">
    Local al proyecto:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git
    cp -r skills/skills/* .claude/skills/
    ```

    O global, para cada proyecto en tu máquina:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.claude/skills/venice
    ```
  </Tab>

  <Tab title="Cursor">
    Local al proyecto:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git .cursor/skills-venice
    ```

    O copia skills individuales:

    ```bash theme={"system"}
    cp -r skills/venice-chat .cursor/skills/
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.codex/skills/venice
    ```

    Para instalaciones locales al proyecto, apunta a `.codex/skills/` en su lugar.
  </Tab>

  <Tab title="OpenCode">
    ```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 también lee `.opencode/skills/`, `.claude/skills/` y `.agents/skills/` desde la raíz del proyecto.
  </Tab>

  <Tab title="Hermes Agent">
    Hermes tiene un instalador integrado para skills de Venice:

    ```bash theme={"system"}
    hermes skills install veniceai/skills
    ```

    O enlaza simbólicamente directamente:

    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git ~/src/venice-skills
    ln -s ~/src/venice-skills/skills ~/.hermes/skills/venice
    ```
  </Tab>

  <Tab title="Cline">
    ```bash theme={"system"}
    git clone https://github.com/veniceai/skills.git .clinerules/skills-venice
    ```
  </Tab>
</Tabs>

### Referencia de rutas

| Runtime        | Local al proyecto                                                  | Global                                       |
| -------------- | ------------------------------------------------------------------ | -------------------------------------------- |
| 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/`                          |

<Tip>
  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.
</Tip>

### Como submódulo de git

Si quieres versiones fijadas en tu propio repo:

```bash theme={"system"}
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`](https://github.com/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

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/skills">
    Código fuente, guía de contribución y plantilla de skill
  </Card>

  <Card title="Venice MCP Server" icon="plug" href="/guides/integrations/venice-mcp">
    Empareja skills con el servidor MCP oficial para acceso a herramientas en runtime
  </Card>

  <Card title="Spec de Agent Skills" icon="arrow-up-right-from-square" href="https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview">
    Conoce el formato subyacente
  </Card>

  <Card title="Spec de la API de Venice" icon="book" href="/api-reference/api-spec">
    La especificación OpenAPI fuente de verdad de la que se derivan estas skills
  </Card>
</CardGroup>
