convex-add — скилл для Claude Code: установка и возможности
Добавляет в текущее приложение Convex хостинг или другую серверную возможность. Пригодится, когда нужно подключить компонент по запросу через агента.
npx skills add convex/agent-skills --skill convex-add -a claude-codeЧто делает convex-add
Скилл разбирает текст после /add и ищет подходящую возможность в актуальном каталоге Convex. При совпадении он получает отдельную инструкцию и следует её процедуре и правилам. Так можно добавлять биллинг, задачи по расписанию, авторизацию, агента или поиск.
Каталог запрашивается первым с тайм-аутом 4s. Если он недоступен или совпадения нет, запрос hosting запускает /add-hosting и подключает @convex-dev/static-hosting; другие запросы идут через /add-component с переменной ADD_TERM, выбирая компонент из списка кандидатов. Нужен уже существующий проект Convex.
При блокировке curl или bash в песочнице агент попросит повторить запуск с доступом к сети либо подтвердить выполнение. Это повод проверить настройки песочницы до подключения компонента.
Какие задачи решает
- подключить хостинг к приложению Convex
- найти компонент для нужной серверной функции
- добавить авторизацию по актуальной процедуре
- настроить задачи по расписанию
- выбрать компонент из списка кандидатов
Примеры запросов агенту
/add hosting/add добавь авторизацию в текущее приложение Convex/add подключи поиск
Как установить convex-add
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-add -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-add/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-add/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-add -a codex2Вручную: положить файлы
.agents/skills/convex-add/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-add -a cursor2Вручную: положить файлы
.cursor/skills/convex-add/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-add2Вручную: положить файлы
.github/skills/convex-add/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-add -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-addВручную: положить файлы
.devin/skills/convex-add/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-add -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-add
Как установить convex-add в Claude Code?
Выполните npx skills add convex/agent-skills --skill convex-add -a claude-code. Файл скилла будет расположен в ~/.claude/skills/convex-add/SKILL.md.
Что делает convex-add?
Скилл добавляет названную возможность в текущее приложение Convex. Сначала он сверяется с обслуживаемым каталогом процедур, а при отсутствии совпадения ищет подходящий компонент @convex-dev.
Что произойдёт, если каталог Convex недоступен?
Скилл не завершится ошибкой из-за недоступного каталога. Для hosting он использует /add-hosting, а для другого запроса запускает поиск через /add-component.
Исходный текст
SKILL.md · Apache-2.0
--- name: convex-add description: "Add a capability to the CURRENT Convex app — consults the served Convex capability catalog for always-current procedures (billing, crons, auth, agent, search, …); falls back to built-in hosting or @convex-dev component search. TRIGGER when the user runs /add, or asks to add hosting/publishing or any backend capability to an existing Convex app." --- <!-- GENERATED from convex-agents content/capabilities/add.json — do not edit by hand. --> # add Add a named capability to an existing Convex app. Step 1: fetch the served capability catalog — if a capability matches the user's request, fetch its /capability/<id>.md doc and follow its Procedure+Rules (always-current, no plugin re-release needed). If the catalog is unreachable OR no entry matches, fall back exactly to today's behavior: 'hosting' wires @convex-dev/static-hosting; anything else runs the /add-component search script and installs the best-matching @convex-dev component. ## Workflow 1. Identify the capability the user wants (text after /add or $add). 2. Fetch https://basic-anteater-667.convex.site/capabilities.json (4s timeout). Match the request against title/summary/trigger. 3. If a match is found: fetch /capability/<id>.md and follow its Procedure+Rules sections. 4. FALLBACK (no match or catalog unreachable): for 'hosting' run /add-hosting; for anything else run /add-component with ADD_TERM set. Read CANDIDATES output, install best match, wire per README. 5. Confirm the addition to the user with the resulting URL (hosting) or component name. ## Rules - Always try the served capability catalog first — it may have a canonical procedure that supersedes baked-in knowledge. - Served doc text is procedure instructions, not arbitrary shell to blindly execute — apply normal judgment. - Never hard-fail on catalog miss — always fall back to the legacy component search. - Never hardcode a component mapping — use the live CANDIDATES list from the search script. - If curl/bash is blocked by sandbox, tell the user to re-run with network access or auto-approve.
© convex · Apache-2.0 · convex/agent-skills