# Convex Env

> Configura y conecta variables de entorno / secretos del deployment de Convex para la app.

Fuente: https://skillsagentes.com/skills/get-convex/agent-skills/convex-env
Markdown: https://skillsagentes.com/skills/get-convex/agent-skills/convex-env.md

Repositorio: https://github.com/get-convex/agent-skills
Autor: get-convex
Licencia: Apache-2.0
Actualizado: el mes pasado
Coste de contexto: 16 tok instalada, 197 tok al activarse, 197 tok con todos los archivos del bundle
Bundle: 1 archivo, 787 B
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add get-convex/agent-skills --skill convex-env --agent claude-code
# Cursor
npx -y skills add get-convex/agent-skills --skill convex-env --agent cursor
# Codex
npx -y skills add get-convex/agent-skills --skill convex-env --agent codex
# Gemini CLI
npx -y skills add get-convex/agent-skills --skill convex-env --agent gemini
# Windsurf
npx -y skills add get-convex/agent-skills --skill convex-env --agent windsurf
# Cline
npx -y skills add get-convex/agent-skills --skill convex-env --agent cline
```

## Qué hace

- Configura variables de entorno y secretos a nivel de deployment en Convex usando npx convex env set
- Establece el patrón de leerlos con process.env dentro de actions, nunca en queries o mutations
- Asegura que los secretos no se guarden en código ni se commiteen al repo

## Cuándo usarla

- Necesitas guardar claves API u otros secretos para una app en Convex
- Quieres leer variables de entorno dentro de una action de Convex
- Necesitas configurar valores distintos por deployment

## Qué la activa

- "Configura la API key de Stripe como variable de entorno en Convex"
- "¿Cómo leo un secreto dentro de una action de Convex?"
- "Necesito que cada deployment tenga su propia env var"

## Antes de instalar

- Requiere el CLI de Convex (npx convex) configurado para el proyecto.

## Archivos

- SKILL.md — 787 B

## SKILL.md

Reproducido tal cual desde get-convex/agent-skills bajo Apache-2.0. Esta sección es el documento original y está en inglés.

<!-- 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 with `npx convex env list`.

## 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.

## Dónde encaja

- Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes.
- Creador: [get-convex](https://skillsagentes.com/creators/get-convex.md) — 33 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Convex Quickstart](https://skillsagentes.com/skills/get-convex/agent-skills/convex-quickstart.md): Levanta un template Next.js + Convex barebones a partir de una idea en una frase.
- [Convex Design](https://skillsagentes.com/skills/get-convex/agent-skills/convex-design.md): Diseña y construye backends reactivos y type-safe de nivel producción en Convex: schema, queries/mutations/actions, índices, auth, storage, scheduling, multiplayer en tiempo real y workflows LLM/agentes.
- [Convex Authz](https://skillsagentes.com/skills/get-convex/agent-skills/convex-authz.md): Audita y refuerza la autorización de una app Convex: impersonación por identity-from-arg, checks de ownership por documento faltantes, queries públicas que filtran datos por un id del cliente y escrituras en un contenedor ajeno.
- [Convex Expert](https://skillsagentes.com/skills/get-convex/agent-skills/convex-expert.md): Especialista en el backend de Convex: código dentro de convex/ (funciones, schemas, índices, queries, mutations, actions, endpoints HTTP, cron jobs, storage, auth y componentes).
- [Convex Agent](https://skillsagentes.com/skills/get-convex/agent-skills/convex-agent.md): Añade un backend de agente de IA / RAG (@convex-dev/agent) a la app Convex.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)