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

convex-add — скилл для Claude Code: установка и возможности

Добавляет в текущее приложение Convex хостинг или другую серверную возможность. Пригодится, когда нужно подключить компонент по запросу через агента.

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

Что делает 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-code

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

~/.claude/skills/convex-add/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Всё по теме «Бэкенд и API» →
convex-security-check waynesutton Проверяет Convex-бэкенд перед слиянием изменений: публичные функции, авторизацию, владение данными, валидацию и секреты. CX Codex +1 2 700установок convex waynesutton Маршрутизирует задачи по Convex к специализированным скиллам и задаёт базовые правила разработки бэкенда. Пригодится на старте любого проекта с Convex. CX Codex +1 5 700установок vtex-io-auth-tokens-and-context vtex Помогает решить, какой токен VTEX IO должен стоять за запросом из бэкенд-приложения: приложение, покупатель или админ. CX Codex +1 1 100установок replica-backend Jakeschincariol Собирает бэкенд клона приложения: авторизацию, миграции базы, доступы, платежи Stripe, письма и фоновые задачи. Читает replica/architecture.md и ведёт чек-лист в replica/backend.md. CX Codex +1 613установок api-auth-key-management Samuel Berthe Скилл помогает спроектировать систему API-ключей для внешних клиентов сервиса. Пригодится при настройке ротации без простоя и разграничении сервисных доступов. CX Codex +1 7 800установок backend-security-coder sickn33 Скилл помогает внедрять защитные практики в бэкенд: настраивает валидацию параметров, предотвращает инъекции и закрывает уязвимости в API. CX Codex +1 1 000установок

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

convex-deploy-guard Скилл проверяет и вслух объявляет целевой деплой Convex перед выполнением команд. Требует прямого согласия для продакшена и блокирует случайные мутации. CX Codex +1 36 000установок convex-design Скилл помогает проектировать бэкенды на Convex: схему, функции, авторизацию, файлы и LLM-сценарии. Пригодится для новых и существующих Convex-проектов. CX Codex +1 36 000установок convex-reviewer Прогоняет функции в каталоге convex/ по чек-листу: авторизация, валидаторы, индексы, реактивность. Пригодится перед выкаткой бэкенда. CX Codex +1 36 100установок convex-docs Проверяет установленную в проекте версию Convex и подтягивает актуальную документацию в markdown вместо устаревшего кода из памяти модели. CX Codex +1 36 100установок convex-advisor Читает 72-часовые инсайты деплоя Convex, находит причину каждого события в коде и отдаёт отчёт с исправлениями. CX Codex +1 35 900установок convex-crons Добавляет периодические фоновые задачи через crons в приложение на Convex. Пригодится, когда нужно настроить регулярное обслуживание базы или очистку данных. CX Codex +1 36 000установок convex-env Скилл настраивает переменные окружения и секреты Convex для приложения. Пригодится, когда значения нужно передавать в deployment и читать в actions. CX Codex +1 36 000установок convex-seed Заполняет таблицы базы данных Convex тестовыми строками или импортирует внешние данные. Помогает настроить окружение для разработки без ручного ввода. CX Codex +1 35 800установок

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

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