#558 · Desarrollo y configuración

Comprobador YAML de GitHub Actions

Revisa un workflow de GitHub Actions antes de subirlo al repositorio. El comprobador busca la estructura principal de on y jobs, identifica jobs y revisa que tengan pasos o acciones reconocibles. También detecta tabulaciones e inconsistencias básicas de YAML. Todo el análisis se hace localmente en el navegador.

Entrada de texto

Configuración
Espacio publicitario

Cómo usar esta herramienta de texto

  1. Pega el contenido del archivo de workflow.
  2. Pulsa “Comprobar GitHub Actions”.
  3. Corrige la estructura o las líneas señaladas.
  4. Confirma el workflow en una rama de prueba cuando sea posible.

Qué hace esta herramienta

Muestra errores y avisos del workflow, con conteo de jobs, pasos y referencias uses detectadas.

Primero se revisan reglas YAML básicas. Después se detectan secciones de primer nivel y se recorren bloques de jobs para localizar runs-on, steps, uses y run.

No consulta el Marketplace ni valida que una acción, versión o secreto exista realmente en GitHub.

Ejemplo

Un job con runs-on: ubuntu-latest y una lista steps: se reconoce como estructura básica válida.

Casos de uso

  • Revisar workflows antes de un pull request.
  • Detectar jobs sin pasos.
  • Encontrar tabulaciones introducidas al copiar YAML.
  • Comprobar rápidamente que existen on y jobs.

Consejos para obtener mejores resultados

  • Conserva una copia del archivo original antes de sustituirlo por el resultado.
  • Revisa secretos, rutas y valores sensibles antes de compartir una configuración.
  • Prueba el archivo resultante en un entorno de desarrollo antes de llevarlo a producción.
  • Mantén una codificación UTF-8 uniforme para evitar caracteres dañados.

Detalles del procesamiento

La herramienta analiza texto e indentación y no necesita credenciales de GitHub. Las expresiones de plantilla de GitHub se tratan como contenido y no se ejecutan.

No puede verificar permisos, secretos, contextos, disponibilidad de runners ni compatibilidad real de acciones externas.

Preguntas frecuentes

¿El comprobador detecta un workflow sin jobs?

Sí. La ausencia de la sección jobs: se marca como error.

¿Revisa si cada job de GitHub Actions tiene steps?

Busca steps: dentro de cada job y genera un aviso cuando no encuentra pasos reconocibles.

¿Valida que actions/checkout@v4 exista realmente?

No. Detecta referencias uses:, pero no consulta GitHub Marketplace ni repositorios externos.

¿Ejecuta expresiones de plantilla durante la revisión?

No. Las expresiones se tratan como texto y nunca se evalúan.

¿Puede comprobar secretos y permisos del repositorio?

No. No tiene acceso al repositorio, a secretos ni a permisos; solo analiza el YAML pegado.

Resumen del módulo

ElementoDescripción
ProcesamientoLocal en el navegador
EntradaTexto o archivo compatible
SalidaResultado, métricas e informe descargable