Skill Generator (SKILL.md)

Diseña runbooks y procedimientos de IA estructurados en formato SKILL.md. Configura triggers de activación, protocolos y pasos verificables.

Metadatos de la Habilidad

Nombre de la Skill

Versión

Categoría

Descripción (Trigger de Progressive Disclosure)

ℹ️ La IA lee este texto para decidir si activa la skill cuando el usuario le pide una tarea.

Directorio de la Skill

Incluir carpeta scripts/ (utilidades ejecutables)Incluir carpeta references/ (manuales y docs extensos)Incluir carpeta examples/ (plantillas de referencia)

Protocolos Críticos

Pasos de Ejecución

Paso 1

Paso 2

Paso 3

Vista Previa de SKILL.md

---
name: docker-deployment-helper
description: >-
  Guía paso a paso para construir imágenes Docker seguras, validar multi-stage builds y desplegar contenedores. Usar cuando el usuario solicite crear Dockerfiles, optimizar contenedores o configurar docker-compose.
version: 1.0.0
---

# docker-deployment-helper

> Habilidad para agentes autónomos y asistentes de codificación.

## Estructura Recomendada

```text
skills/docker-deployment-helper/
├── SKILL.md          # Instrucciones principales y triggers
├── scripts/          # Scripts ejecutables y utilidades
├── references/       # Documentación y manuales extensos
```

## Protocolos Críticos

- ⚠️ **NUNCA usar el tag :latest en entornos de producción.**
- ⚠️ **Verificar que los secrets y archivos .env no se copien en la imagen final.**
- ⚠️ **Comprobar siempre el tamaño final de la imagen con 'docker images'.**

## Procedimiento de Ejecución

### Paso 1: Auditoría de dependencias y .dockerignore

Verificar la presencia de .dockerignore excluyendo node_modules, .git y archivos de credenciales.

```bash
cat .dockerignore
```

### Paso 2: Construcción multi-stage

Compilar la aplicación usando una fase de build y una imagen mínima de runtime (alpine o distroless).

```bash
docker build -t app:v1.0.0 .
```

### Paso 3: Verificación de salud

Levantar el contenedor localmente y verificar que el endpoint /healthz responda HTTP 200.

```bash
curl -f http://localhost:8080/healthz
```

## Criterio de Aceptación y Verificación

- [ ] Todos los comandos se ejecutaron sin código de error.
- [ ] Se respetaron los protocolos críticos definidos arriba.
- [ ] El agente confirmó la solución con pruebas o verificación visual.