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

> Offizielle Venice Agent Skills laden Endpunkt-Wissen in Claude Code, Cursor, Codex, OpenCode, Hermes und Cline für korrekte Venice-API-Aufrufe.

[Venice Skills](https://github.com/veniceai/skills) ist die kanonische Sammlung von [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) für die Venice-API. Jeder Skill ist ein eigenständiger Ordner mit einer `SKILL.md`, die ein LLM-Agent bei Bedarf lädt, um korrekt gegen einen bestimmten Bereich der API zu arbeiten.

<Card title="GitHub: veniceai/skills" icon="github" href="https://github.com/veniceai/skills">
  19 Skills, die die gesamte Venice-API abdecken. MIT-Lizenz. Synchron gehalten mit der öffentlichen [`swagger.yaml`](/api-reference/api-spec).
</Card>

<CardGroup cols={3}>
  <Card title="19 Skills" icon="layer-group">
    Einer pro Venice-API-Bereich
  </Card>

  <Card title="Runtime-unabhängig" icon="plug">
    Funktioniert mit Claude Code, Cursor, Codex, OpenCode, Hermes, Cline und jedem anderen Agent-Skills-Host
  </Card>

  <Card title="Mit Spezifikation synchronisiert" icon="rotate">
    Abgeleitet aus Venices OpenAPI-Spezifikation mit CI-Checks gegen Drift
  </Card>
</CardGroup>

## Warum Skills?

Ohne Skills muss dein Agent Venices Eigenheiten auf die harte Tour entdecken: `venice_parameters`, Model-Type-Enums, 402-Payment-Required-Flows, Video-Queue-/Retrieve-Lebenszyklus, Character-Slugs und so weiter. Skills bündeln dieses Wissen in fokussierten On-Demand-Dateien, sodass der Agent nur lädt, was für die aktuelle Aufgabe nötig ist.

Jede `SKILL.md` enthält:

* Den/die abgedeckten Endpoint(s)
* Erforderliche Header, Parameter und Response-Shapes
* Ein curl-Beispiel plus ein minimales SDK-Beispiel
* Einen Abschnitt „Gotchas" mit den Dingen, über die echte Integratoren stolpern

## Skill-Katalog

| Skill                        | Abdeckung                                                                                 |
| ---------------------------- | ----------------------------------------------------------------------------------------- |
| `venice-api-overview`        | Base URL, Auth-Modi, Response-Header, Preismodell, Versionierung                          |
| `venice-auth`                | Bearer-API-Keys + Sign-In-With-X / x402 Wallet-Authentifizierung                          |
| `venice-chat`                | `/chat/completions` mit `venice_parameters`, multimodal, Tools, Reasoning, Streaming      |
| `venice-responses`           | `/responses`, die OpenAI-kompatible Responses-API (Alpha)                                 |
| `venice-embeddings`          | `/embeddings`-Modelle, Encoding-Formate, Dimensionen                                      |
| `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`        | `/audio/speech` TTS-Modelle, Stimmen, Formate, Streaming                                  |
| `venice-audio-music`         | `/audio/quote`, `/audio/queue`, `/audio/retrieve`, `/audio/complete`                      |
| `venice-audio-transcription` | `/audio/transcriptions` mit Whisper, Parakeet, Scribe, Wizper, xAI STT                    |
| `venice-video`               | `/video/*`-Generierung + Transkription                                                    |
| `venice-models`              | `/models`, `/models/traits`, `/models/compatibility_mapping`                              |
| `venice-characters`          | `/characters*` + `venice_parameters.character_slug`                                       |
| `venice-api-keys`            | CRUD `/api_keys`, Rate Limits, Web3-Key-Generierung                                       |
| `venice-billing`             | `/billing/balance`, `/billing/usage`, `/billing/usage-analytics`                          |
| `venice-x402`                | `/x402/*` Wallet-Credits, USDC auf Base oder Solana                                       |
| `venice-crypto-rpc`          | `/crypto/rpc/*` JSON-RPC-Proxy mit 1×/2×/4×-Preisstaffeln                                 |
| `venice-augment`             | `/augment/text-parser`, `/augment/scrape`, `/augment/search`                              |
| `venice-errors`              | Fehler-Shapes, 402 Payment Required, 422 Content Policy, 429 Rate Limits, Retry-Strategie |

## Installation

Jeder Skill ist nur ein Ordner mit einer `SKILL.md`, die mit YAML-Frontmatter beginnt:

```yaml theme={"system"}
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
```

Lege den `skills/`-Ordner (oder eine Teilmenge davon) in den Pfad, den deine Runtime überwacht.

<Tabs>
  <Tab title="Claude Code">
    Projekt-lokal:

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

    Oder global, für jedes Projekt auf deinem Rechner:

    ```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">
    Projekt-lokal:

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

    Oder einzelne Skills kopieren:

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

    Für projekt-lokale Installationen stattdessen `.codex/skills/` als Ziel verwenden.
  </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 liest außerdem `.opencode/skills/`, `.claude/skills/` und `.agents/skills/` aus dem Projekt-Root.
  </Tab>

  <Tab title="Hermes Agent">
    Hermes hat einen integrierten Installer für Venice-Skills:

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

    Oder direkt verlinken:

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

### Pfad-Referenz

| Runtime         | Projekt-lokal                                                   | Global                                          |
| --------------- | --------------------------------------------------------------- | ----------------------------------------------- |
| Claude Code     | `.claude/skills/`                                               | `~/.claude/skills/`                             |
| Codex           | `.codex/skills/`                                                | `~/.codex/skills/` (oder `$CODEX_HOME/skills/`) |
| OpenCode        | `.opencode/skills/` (auch `.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.                                           |
| Andere Runtimes | `.agents/skills/` (Konvention)                                  | `~/.agents/skills/`                             |

<Tip>
  Runtimes, die zusätzliche Frontmatter-Felder definieren (`version`, `platforms`, `metadata.*`, `compatibility`, …), müssen laut Spezifikation unbekannte Felder ignorieren – dieselbe Skill-Datei funktioniert also überall ohne Forks.
</Tip>

### Als Git-Submodul

Wenn du in deinem eigenen Repo gepinnte Versionen möchtest:

```bash theme={"system"}
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
```

Anschließend die gewünschten Teilmengen in den Skill-Pfad deines Agents verlinken oder kopieren.

## Wie Agents sie laden

Der Agent erkennt jede `SKILL.md` anhand der Frontmatter-Felder `name` und `description`. Wenn die Nutzer-Frage zum Zweck eines Skills passt, lädt der Agent genau diese Datei in den Kontext (nicht den gesamten Katalog), sodass der Prompt klein und die Antwort genau bleibt.

Ein Agent, der zum Beispiel Musik generieren muss, lädt `venice-audio-music` und weiß sofort:

* Dass Musik den Queue-/Retrieve-/Complete-Lebenszyklus durchläuft und nicht über einen synchronen Endpoint geht
* Welche Modelle verfügbar sind und welche Preise pro Minute gelten
* Wie man zur Kostenabschätzung zuerst `/audio/quote` aufruft
* Wie der Polling-Backoff aussehen sollte

Ohne den Skill würde der Agent vielleicht `/audio/speech` für Musik aufrufen und eine nutzlose Antwort bekommen.

## Einen neuen Skill schreiben

1. Kopiere `template/` nach `skills/<your-skill>/`.
2. Fülle Frontmatter und Body aus. Halte `description` konkret, denn das ist es, was ein Agent zur Auswahl heranzieht.
3. Verlinke verwandte Skills am Ende für Cross-Navigation.
4. Öffne einen PR gegen [`veniceai/skills`](https://github.com/veniceai/skills).

Siehe die `CONTRIBUTING.md` des Repos für Style-Konventionen (kurzer erster Absatz, explizite Endpoint-Tabellen, curl + ein SDK-Beispiel, „Gotchas"-Abschnitt, ≤ 500 Zeilen).

## Ressourcen

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/veniceai/skills">
    Quellcode, Contributing-Guide und Skill-Template
  </Card>

  <Card title="Venice MCP Server" icon="plug" href="/guides/integrations/venice-mcp">
    Skills mit dem offiziellen MCP-Server für Runtime-Tool-Zugriff kombinieren
  </Card>

  <Card title="Agent Skills-Spezifikation" icon="arrow-up-right-from-square" href="https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview">
    Erfahre mehr über das zugrunde liegende Format
  </Card>

  <Card title="Venice API-Spezifikation" icon="book" href="/api-reference/api-spec">
    Die OpenAPI-Quelle, von der diese Skills abgeleitet sind
  </Card>
</CardGroup>
