Un overlay de producción con literales de secretGenerator como DB_PASSWORD=... deja la contraseña de la base de datos en git para cualquiera que tenga el repositorio, y el Secret que genera solo está en base64. Una base remota escrita como https://github.com/org/platform//base sin ?ref= despliega lo que haya en la rama por defecto el día en que compilas. Y un overlay que nunca define un namespace envía los objetos de producción al namespace que use el contexto actual de kubectl. Esta skill detecta esos y los demás errores de Kustomize que se indican abajo, y te explica cómo corregir cada uno.

Tu agente ejecuta un escáner sobre cada archivo kustomization.yaml, kustomization.yml y Kustomization (kustomizations y components). Sigue las bases locales como ../../base para ver si alguna define un namespace, y abre los archivos env y los archivos que lee secretGenerator para comprobar si contienen valores reales y si .gitignore los mantiene fuera de git. Conoce los campos y elementos obsoletos actuales de Kustomize v5, las formas de las URL remotas y que un ref puede ser una rama, una etiqueta o un hash de commit completo. Los archivos env cifrados con SOPS, los marcadores ${VAR} y los objetos Kustomization de Flux no se reportan. Nunca ejecuta kustomize, kubectl, helm ni git. 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)

• K01: secretos escritos en la kustomization: literales de secretGenerator, literales de configMapGenerator con nombres de secretos, valores secretos y variables de entorno secretas en valuesInline de helmCharts, data de Secret o valores env secretos en parches inline, una contraseña en una URL remota, o un token de GitHub, GitLab, Slack, npm o AWS en cualquier parte del archivo (las claves que solo nombran un Secret, como tlsSecret: proxy-tls, no se tocan)
• K02: archivos env y archivos de claves de secretGenerator (o archivos env de configMapGenerator con nombres de secretos) guardados en el repositorio con valores reales y sin regla en .gitignore
• K03: bases git remotas, resources o components sin ref ni versión
• K04: resources remotos, bases o repositorios de charts de Helm a través de http:// sin cifrar

REVIEW (revisar antes del lanzamiento)

• K11: refs remotos que cambian: una rama (main, stable, release-1.28), un hash de commit corto, una URL de archivo raw en una rama, una descarga de releases/latest o una URL de archivo sin versión
• K12: helmCharts sin versión, con latest o con un rango de versiones
• K13: imágenes con newTag latest, main, nightly u otra etiqueta cambiante y sin digest
• K14: campos obsoletos (bases, patchesStrategicMerge, patchesJson6902, vars, imageTags, helmChartInflationGenerator), y el env de un generador, la forma singular antigua de envs que kustomize edit fix fusiona en envs
• K15: commonLabels, que también reescribe selectores que no se pueden cambiar en cargas de trabajo en ejecución
• K16: disableNameSuffixHash: true, de modo que la configuración modificada no reinicia los pods
• K17: overlays que no definen namespace, namePrefix ni nameSuffix, sobre una base local que tampoco define namespace (las bases que solo contienen tipos de ámbito de clúster como ClusterIssuer o ClusterRole no se tocan)
• K18: archivos cargados desde fuera de la carpeta de la kustomization, que el load restrictor predeterminado rechaza

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 la fuente oficial de cada regla
• Un repositorio de ejemplo arriesgado y uno seguro (una base, un overlay de producción y una kustomization de plataforma), y el informe real que genera el escáner sobre el arriesgado

Limitaciones

Lee los archivos kustomization tal como están escritos y no ejecuta el build, así que no se comprueba lo que producen los parches, components, replacements y plantillas de Helm, ni los propios manifiestos de Kubernetes. Las bases y charts remotos no se descargan. Si un archivo está en el repositorio se decide solo a partir de los archivos .gitignore. Las etiquetas y las ramas se distinguen por sus nombres. No se conoce un namespace definido por una Application de Argo CD o una Kustomization de Flux. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 27 archivos: SKILL.md, el escáner en scripts/ (8 archivos Python), references/rules.md (cada regla con su motivo y enfoque más seguro) y examples/ (16 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.