К основному содержанию
скилл CX Codex

my-venice-skill — скилл для Claude Code: шаблон скилла Venice API

Заготовка скилла для агентов: структура разделов, примеры запросов к Venice API и таблица ошибок. Пригодится, когда пишете свой скилл под Venice.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add veniceai/skills --skill template -a claude-code
Открыть на GitHub

Что делает my-venice-skill

Это шаблон, а не готовый инструмент. Внутри — каркас SKILL.md с разделами: эндпоинты в таблице, быстрый старт с curl и SDK, обязательные и опциональные параметры, пример ответа, таблица ошибок и заметки о подводных камнях. Описание во фронтматтере задаёт, когда агент должен подгрузить скилл: чем конкретнее указаны эндпоинты и сценарии, тем точнее выбор.

Быстрый старт показывает запрос к https://api.venice.ai/api/v1/example с заголовком Authorization: Bearer $VENICE_API_KEY. То есть для реальной работы понадобится ключ Venice в переменной окружения VENICE_API_KEY — без него примеры не выполнятся. В таблице ошибок 400 разбирается как неверный ввод, 429 — как превышение лимита запросов с рекомендацией отступать с джиттером.

Установка идёт через npx skills add veniceai/skills --skill template -a <агент>, для GitHub Copilot — через gh skill install. Пути различаются: Claude кладёт файл в ~/.claude/skills/template/SKILL.md, Cursor — в .cursor/skills/template/SKILL.md, Codex — в .agents/skills/template/SKILL.md. В конце шаблона стоят перекрёстные ссылки на родственные скиллы вроде venice-errors и venice-billing — их придётся заменить на свои.

Какие задачи решает

  • завести новый скилл под Venice API без пустого файла
  • описать эндпоинты и параметры так, чтобы агент выбирал скилл уверенно
  • показать агенту примеры запросов с ключом из переменной окружения
  • разложить коды ошибок API по причинам и способам починки
  • связать новый скилл с соседними через перекрёстные ссылки

Примеры запросов агенту

  • Заполни SKILL.md для нового скилла: эндпоинт POST /example, обязательные параметры и пример ответа
  • Добавь в раздел ошибок строку для 429 и объясни, как отступать с джиттером
  • Замени перекрёстные ссылки в конце шаблона на мои скиллы

Как установить my-venice-skill

1Через Skills CLI (Vercel)

npx skills add veniceai/skills --skill template -a claude-code

2Вручную: положить файлы

~/.claude/skills/template/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/template/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о my-venice-skill

Как установить my-venice-skill в Claude Code?

Выполните npx skills add veniceai/skills --skill template -a claude-code. Файл появится по пути ~/.claude/skills/template/SKILL.md.

Что делает my-venice-skill?

Даёт каркас скилла для Venice API: таблицу эндпоинтов, примеры запросов, разбор параметров, ответа и ошибок. Вы наполняете его своими данными.

Что нужно, чтобы примеры запросов заработали?

Ключ Venice в переменной окружения VENICE_API_KEY: в примере он подставляется в заголовок Authorization: Bearer $VENICE_API_KEY.

Исходный текст

SKILL.md · MIT
---
name: my-venice-skill
description: One or two sentences describing exactly when an agent should load this skill and what it covers. Mention the specific endpoints, parameters, or scenarios so the agent can confidently pick it — vague descriptions hurt skill selection.
---

# My Venice skill

One-paragraph summary of what this skill teaches the agent. Focus on which Venice API surface it maps to and when to prefer it over related skills.

## Endpoints

| Method | Path | Notes |
|---|---|---|
| `POST` | `/example` | Required params, authentication, cost model. |

## Quick start

```bash
curl -X POST https://api.venice.ai/api/v1/example \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "foo": "bar" }'
```

```ts
// SDK or fetch example
```

## Parameters

### Required

- `field_a` — what it is, valid range, default.

### Optional

- `field_b` — …

## Response

```json
{
  "example": "response"
}
```

## Errors

| Status | Cause | Fix |
|---|---|---|
| `400` | Bad input | Validate against the schema. |
| `429` | Rate limit | Back off with jitter. |

## Gotchas

- Specific edge cases, rate-limit caps, model constraints.
- Cross-links to related skills: [`venice-errors`](../venice-errors/SKILL.md), [`venice-billing`](../venice-billing/SKILL.md), etc.

© veniceai · MIT · veniceai/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
skill-name claude-office-skills Шаблон скилла из набора Claude Office Skills: задаёт структуру метаданных и разделов для скиллов по документам и юридическим задачам. CX Codex +1 4 500установок convex convex Скилл-маршрутизатор для работы с бэкендом Convex: отправляет задачу нужному навыку из набора convex-* и подтягивает свежие инструкции из серверного каталога. CX Codex +1 108 300установок hindsight-docs vectorize-io Скилл даёт агенту документацию Hindsight: архитектуру, API, настройку и SDK. Пригодится для интеграции памяти в AI-агентов. CX Codex +1 9 200установок langchain4j-ai-services-patterns giuseppe-trisciuoglio Скилл показывает, как собирать декларативные AI Services на LangChain4j: интерфейсы, аннотации, память и вызов инструментов. CX Codex +1 3 700установок langchain4j-tool-function-calling-patterns giuseppe-trisciuoglio Скилл подсказывает агенту, как описывать Java-методы через @Tool, регистрировать их в AiServices и обрабатывать ошибки вызова. CX Codex +1 3 700установок convex-agents waynesutton Скилл учит ИИ строить агентов на компоненте @convex-dev/agent. Пригодится для чатов с историей тредов, RAG и вызова мутаций Convex как инструментов. CX Codex +1 1 500установок

Из того же набора8

venice-video Скилл для асинхронной генерации видео через Venice API: текст-в-видео, картинка-в-видео, переходы по первому и последнему кадру, апскейл. Пригодится, когда нужен ролик из промпта прямо из агента. CX Codex +1 ★ 160звёзд репо venice-models Скилл показывает, какие модели есть в Venice API, что они умеют и сколько стоят. Пригодится, когда модель выбирается в коде, а не руками. CX Codex +1 ★ 160звёзд репо venice-errors Скилл объясняет формы ошибок Venice API и стратегию повторов, чтобы агент не выжигал лимит запросов. Нужен тем, кто пишет клиент к Venice. CX Codex +1 ★ 160звёзд репо venice-crypto-rpc Подключает агента к блокчейн-сетям через платный JSON-RPC-прокси Venice: один запрос — один счёт за кредиты. CX Codex +1 ★ 160звёзд репо venice-billing Скилл для работы с биллингом Venice AI: остаток DIEM и кредитов, журнал запросов, агрегированная аналитика. Нужен админский ключ. CX Codex +1 ★ 160звёзд репо venice-audio-voice-changer Скилл для асинхронной замены голоса в готовой записи через Venice API: речь остаётся той же, тембр — другой. CX Codex +1 ★ 160звёзд репо venice-audio-music Скилл для асинхронной генерации музыки, звуковых эффектов и длинной озвучки через Venice API. Пригодится, когда синхронный вызов уже не дожидается ответа. CX Codex +1 ★ 160звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой