convex-optimize — скилл для Claude Code: аудит и оптимизация Convex
Скилл проводит аудит существующего приложения на Convex и предлагает план правок: безопасность, масштаб, обновления компонентов, наблюдаемость.
npx skills add convex/agent-skills --skill convex-optimize -a claude-codeЧто делает convex-optimize
Скилл сначала находит приложение: каталог convex/, схему и тип развёртывания — анонимное или облачное. Дальше он не считает баллы сам, а берёт готовый отчёт у launch-readiness — тот собирает оценки по authz, reviewer, advisor и insights и выдаёт упорядоченный план исправлений. В этом и смысл: optimize работает с результатом, а не повторяет проверки заново.
К отчёту добавляются обновления. Скилл запускает check-updates по закреплённым компонентам @convex-dev/* и вносит устаревшие в тот же план. Если в отчёте видно, что в продакшене не ловится ошибок, он предложит поставить sentinel. Потом показывает общий план — оценка, исправления, апгрейды, наблюдаемость, и риски безопасности с потерей данных идут первыми.
Меняет файлы скилл только после явного подтверждения и никогда не катит правки в чужой продакшен сам. После применения он прогоняет оценку заново и показывает разницу в баллах. Работать он будет там, где есть каталог convex/ и установленный набор скиллов из convex/agent-skills.
Какие задачи решает
- оценить готовность приложения на Convex к запуску
- найти устаревшие компоненты
@convex-dev/*и обновить их - закрыть дыры в авторизации до выхода в продакшен
- настроить отлов ошибок в продакшене
- проверить, что правки не сломали безопасность
Примеры запросов агенту
- проведи аудит моего приложения на Convex и покажи план исправлений
- какие компоненты
@convex-dev/*устарели и что с ними делать - в отчёте нет отлова ошибок в продакшене — что поставить
Как установить convex-optimize
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-optimize -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-optimize/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-optimize/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-optimize -a codex2Вручную: положить файлы
.agents/skills/convex-optimize/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-optimize -a cursor2Вручную: положить файлы
.cursor/skills/convex-optimize/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-optimize2Вручную: положить файлы
.github/skills/convex-optimize/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-optimize -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-optimizeВручную: положить файлы
.devin/skills/convex-optimize/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-optimize -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-optimize
Как установить convex-optimize в Claude?
Выполните npx skills add convex/agent-skills --skill convex-optimize -a claude-code. Скилл окажется в ~/.claude/skills/convex-optimize/SKILL.md.
Что делает convex-optimize?
Проводит аудит существующего приложения на Convex через отчёт launch-readiness, добавляет к нему обновление устаревших компонентов и настройку наблюдаемости, а затем применяет правки после подтверждения.
Он сам меняет код в продакшене?
Нет. Скилл сначала читает и показывает план, применяет правки только после явного подтверждения и после этого перезапускает оценку, чтобы показать разницу в баллах.
Исходный текст
SKILL.md · Apache-2.0
--- name: convex-optimize description: "Audit and optimize an existing Convex app: security, scale, upgrades, observability." --- <!-- GENERATED from convex-agents content/capabilities/optimize.json — do not edit by hand. --> # Audit and optimize an existing Convex app The remediation WORKFLOW for an existing app: open with a scored assessment, then act on it — upgrade stale components and set up observability — plan-then-confirm-then-apply. The assessment itself is delegated to launch-readiness (the findings-bus scorer); optimize's distinct value is the actions it takes on the result. ## Workflow 1. Detect the app: a `convex/` directory, the schema, and whether it's an anonymous or cloud deployment. 2. ASSESS via `launch-readiness` — one scored, deduped report across authz/reviewer/advisor/insights with an ordered fix plan. Do not re-run those passes by hand; optimize consumes launch-readiness's report rather than re-implementing the audit. 3. UPGRADE: run `check-updates` against the pinned `@convex-dev/*` components and fold stale-component (staleness-class) findings into the same plan. 4. OBSERVABILITY: if the readiness report flagged an observability gap (no prod error capture), offer to install `sentinel`. 5. Present the combined prioritized plan — the launch-readiness score + the fix plan + upgrades + observability, security/data-loss first — and apply only on explicit confirmation, dispatching each fix to its fixCapability. 6. After applying, re-run the launch-readiness assessment and show the score delta. ## Rules - Read-only first. Present a plan and CONFIRM before changing any file. - Delegate the audit to launch-readiness (the findings-bus scorer); don't re-implement reviewer/advisor/insights inline — optimize's job is acting on the report (upgrades + observability), not re-scoring. - Prioritize security and data-loss risks above style, following launch-readiness's ordering. - Never auto-land changes on someone's existing prod app; re-assess after applying and show the score moved.
© convex · Apache-2.0 · convex/agent-skills
