my-venice-skill — скилл для Claude Code: шаблон скилла Venice API
Заготовка скилла для агентов: структура разделов, примеры запросов к Venice API и таблица ошибок. Пригодится, когда пишете свой скилл под Venice.
npx skills add veniceai/skills --skill template -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/template/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/template/
1Через Skills CLI (Vercel)
npx skills add veniceai/skills --skill template -a codex2Вручную: положить файлы
.agents/skills/template/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add veniceai/skills --skill template -a cursor2Вручную: положить файлы
.cursor/skills/template/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install veniceai/skills template2Вручную: положить файлы
.github/skills/template/SKILL.md1Через Skills CLI (Vercel)
npx skills add veniceai/skills --skill template -a gemini-cli2Командой платформы
gemini skills install https://github.com/veniceai/skills --path templateВручную: положить файлы
.devin/skills/template/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add veniceai/skills --skill template -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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