Un SESSION_SECRET en [env] llega a cualquiera que pueda leer el repositorio, un bloque [[services]] para Redis le da a la caché una dirección pública en el primer despliegue, y una entrada [[statics]] que apunta a /app sirve tu .env y tus archivos fuente a quien los pida. Esta skill detecta esos y los demás errores de configuración de Fly.io que se indican abajo antes de desplegar, y te explica cómo corregir cada uno.

Tu agente ejecuta un escáner sobre fly.toml y sus variantes (fly.staging.toml, fly.production.toml) y sobre el Dockerfile que fly deploy compila para él (su WORKDIR, COPY . ., ENV PORT y comando de inicio). Lee el TOML con un número de línea para cada clave, conoce los valores por defecto de [http_service] y [[services]] (puerto interno 8080, puertos 80 y 443), los handlers tls y pg_tls y los grupos de procesos, omite marcadores, referencias ${...} y claves públicas por diseño, y nunca ejecuta flyctl, Docker ni tu aplicación. Devuelve BLOCK, REVIEW o NOT FLAGGED, con el archivo, la línea, el motivo y un enfoque más seguro. Los secretos nunca se muestran.

Qué comprueba

BLOCK (corregir antes de publicar)

• F01: contraseñas, tokens, claves y cadenas de conexión con contraseña escritas en [env], [build.args], comandos de proceso, release o console (también un flag y su valor en elementos separados del array), cabeceras de health checks o un raw_value de [[files]]
• F02: un puerto de base de datos o de caché (PostgreSQL, MySQL, Redis, MongoDB y otros) servido como TCP simple sin handler tls ni pg_tls, salvo que un comentario marque la aplicación como privada (# flycast only)
• F03: [[statics]] que sirven / o una carpeta del sistema, o la carpeta en la que el Dockerfile copia todo el proyecto

REVIEW (revisar antes del lanzamiento)

• F11: [http_service] o un puerto http sin force_https = true
• F12: SSH, un puerto de base de datos con TLS en el proxy, o un puerto de base de datos sin cifrar en una aplicación marcada como privada
• F13: un servicio público sin ningún tipo de health check
• F14: una imagen de [build] o una imagen de machine_checks sin etiqueta o en latest
• F15: un internal_port que no coincide con PORT o HTTP_PORT de [env], con el ENV PORT del Dockerfile o con un flag --port/--bind del comando de inicio, o una aplicación enlazada a localhost
• F16: auto_stop_machines activado en una aplicación de base de datos o de caché que tiene un volumen
• F17: un release_command que necesita el volumen (los comandos de release se ejecutan sin volúmenes), como una migración de SQLite
• F18: ajustes que Fly rechaza o ignora: canary o bluegreen con volúmenes, bluegreen sin health check, force_https en un puerto que no es http, un volumen montado en /, variables FLY_, suspend con swap o con más de 2 GB (memory, memory_mb o el preset size), y grupos de procesos desconocidos
• F19: una variable de [env] o [build.args] con nombre de secreto establecida en una palabra por defecto como password, changeme o admin
• F20: [[statics]] sobre la raíz web de nginx, Caddy o httpd que el Dockerfile llena con todo el contexto de build

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar)
• Una guía de reglas con el motivo, el enfoque más seguro y el enlace a la documentación oficial de Fly.io para cada regla
• Un proyecto de ejemplo arriesgado y uno seguro (una aplicación web, una aplicación Redis y un sitio de documentación estático, cada uno con fly.toml, además de sus Dockerfiles), y el informe real que genera el escáner sobre el arriesgado

Limitaciones

Lee fly.toml y el Dockerfile tal como están escritos. No puede ver las direcciones IP de tu aplicación, los valores definidos con fly secrets ni los cambios hechos con fly scale o la Machines API, así que las reglas de puertos de bases de datos y SSH asumen el comportamiento por defecto de Fly, que asigna direcciones públicas a las aplicaciones con servicios (un comentario "# flycast only" marca una aplicación como privada), y F19 no puede saber si un secreto de Fly sobrescribe el valor por defecto. La plantilla de fly launch de la mayoría de los frameworks no crea ningún health check, así que espera F13 en ese caso. Los puertos elegidos en el código o en un Procfile no se siguen, y la seguridad del propio Dockerfile no se comprueba. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 23 archivos: SKILL.md, el escáner en scripts/ (6 archivos Python), references/rules.md (cada regla con su motivo y enfoque más seguro) y examples/ (14 archivos de ejemplo más report.md, la salida real del escáner sobre el ejemplo arriesgado).

Cómo usarla: Esta es una skill para agentes: una carpeta con un archivo SKILL.md y scripts de Python que un agente de programación con IA como Claude Code, Cursor o Codex CLI puede ejecutar. Descomprímela en la carpeta de skills de tu agente (para Claude Code: ~/.claude/skills/) y luego pide a tu agente que revise tu proyecto. Los scripts también funcionan por sí solos con Python 3.9 o posterior, sin instalar nada. Solo leen tus archivos: sin acceso a la red, y no se envía nada a ningún sitio.