Skip to content
Back to skills

Docs Env

ASecurity

Cruza las variables de entorno que lee el código con .env.example y la documentación, y reporta las que faltan en cada lado y las declaradas que nadie usa.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobash

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill docs-env --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Docs Env?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Docs Env
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-docs-env/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-docs-env)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: docs-env
description: Cruza las variables de entorno que lee el código con .env.example y la documentación, y reporta las que faltan en cada lado y las declaradas que nadie usa.
license: MIT
metadata:
  package: docs-sync-engine
  version: "1.1.0"
---

# Docs Env

## Objetivo

Que quien clona el repositorio sepa qué variables necesita antes de ejecutarlo: si el código lee una variable que no está en `.env.example`, el arranque falla en la primera máquina nueva.

## Instrucciones de ejecución

1. Cruza código, ejemplo y documentación:

```bash
py docs-sync-engine/scripts/env_check.py --path src/ --env-example .env.example --docs README.md --json
```

2. Añade a `.env.example` cada `env-sin-ejemplo` con un valor de mentira, nunca el real.
3. Cada `env-sin-documentar` se nombra en el README o en la guía de despliegue, con su formato y su efecto.

## Reglas

| Regla | Severidad | Qué señala |
|---|---|---|
| `env-sin-ejemplo` | media | El código la lee y no está en `.env.example` |
| `env-sin-documentar` | media | El código la lee y no aparece en la documentación |
| `ejemplo-sin-uso` | baja | Está en `.env.example` y ningún fichero la lee |

Reconoce `os.environ[...]`, `os.environ.get`, `os.getenv`, `process.env.X` e `import.meta.env.X`, y en `.env.example` acepta tanto `CLAVE=` como `export CLAVE=`.

## Límites

- Solo estático: una variable construida por concatenación o leída desde configuración externa no se ve.
- La documentación se reconoce por el nombre en mayúsculas dentro de los ficheros indicados; un README que la describe sin nombrarla cuenta como no documentada.
- No valida valores ni formato: comprueba presencia, no corrección.

## Gate de salida

- Cero variables usadas sin ejemplo ni documentación, o cada excepción justificada.
- `.env.example` sin secretos reales y con las variables nuevas.
- Número de variables usadas, declaradas y documentadas anotado junto al informe.

## Handoff

Entrega a `docs-drift-check` las rutas de los documentos tocados y a `docs-changelog` las variables nuevas de la versión, para que la nota de release las nombre.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.