convex-env — скилл для Claude Code: что делает и установка
Скилл настраивает переменные окружения и секреты Convex для приложения. Пригодится, когда значения нужно передавать в deployment и читать в actions.
npx skills add convex/agent-skills --skill convex-env -a claude-codeЧто делает convex-env
convex-env помогает задать секреты как переменные окружения Convex через npx convex env set KEY value, а затем читать их через process.env.KEY внутри actions. Для actions может понадобиться 'use node'. В queries и mutations такой доступ использовать нельзя.
Секреты нельзя хранить в коде или коммитить в Git. Для локальной работы их можно добавить в .env.local, а разные deployment требуют собственных значений. Проверить список заданных имён можно командой npx convex env list --names-only, которая не выводит сами секреты. Это повод отдельно проверить каждый deployment перед запуском: одинаковое имя переменной не означает, что значение уже задано в нём.
Какие задачи решает
- задать секрет для Convex deployment
- прочитать переменную окружения внутри action
- разнести значения по разным deployment
- проверить имена заданных секретов без их вывода
- не допустить попадания ключей в код и Git
Примеры запросов агенту
- Настрой секреты Convex для текущего deployment и покажи команды проверки имён переменных.
- Проверь, где в проекте читаются значения через
process.env, и исправь использование в queries или mutations. - Добавь локальные значения в
.env.local, а для deployment задай их черезnpx convex env set KEY value.
Как установить convex-env
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-env -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-env/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-env/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-env -a codex2Вручную: положить файлы
.agents/skills/convex-env/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-env -a cursor2Вручную: положить файлы
.cursor/skills/convex-env/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-env2Вручную: положить файлы
.github/skills/convex-env/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-env -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-envВручную: положить файлы
.devin/skills/convex-env/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-env -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-env
Как установить convex-env в Claude Code?
Выполните npx skills add convex/agent-skills --skill convex-env -a claude-code, затем повторите npx skills add convex/agent-skills --skill convex-env -a claude-code. Файл скилла находится по пути ~/.claude/skills/convex-env/SKILL.md.
Что делает convex-env?
Скилл задаёт переменные окружения и секреты Convex, показывает, как читать их через process.env.KEY в actions, и проверяет имена без печати значений.
Где convex-env разрешает читать переменные окружения?
Только внутри actions. В queries и mutations доступ через process.env использовать нельзя; для нужных actions может потребоваться 'use node'.
Исходный текст
SKILL.md · Apache-2.0
---
name: convex-env
description: "Set and wire Convex deployment env vars / secrets for the app."
---
<!-- GENERATED from convex-agents content/capabilities/env.json — do not edit by hand. -->
# Manage env vars + secrets
Store secrets as Convex deployment env vars (npx convex env set), read them with process.env in actions, never commit them.
## Workflow
1. `npx convex env set KEY value` (per deployment).
2. Read via process.env.KEY inside actions (not queries/mutations).
3. Never hardcode or commit secrets; add to .env.local only for local.
4. Confirm it's set with `npx convex env list --names-only`, which lists names without printing the secret values.
## Rules
- Secrets live in Convex env vars, never in code or git.
- process.env only in actions ('use node' if needed), not queries/mutations.
- Different deployments need their own values.
- Check what is set with `npx convex env list --names-only`; never print secret values into the conversation.
© convex · Apache-2.0 · convex/agent-skills
