Authoring GitHub Workflows

Redacta y revisa YAML de GitHub Actions para que no pueda enviarse un workflow roto.

Por dotnet · dotnet/skills

Funciona con configuración ★ 7.2/10

Authoring GitHub Workflows — Redacta y revisa YAML de GitHub Actions para que no pueda enviarse un workflow roto.

Qué hace

Redacta y revisa de forma segura el YAML de workflows de GitHub Actions, de modo que un YAML sintácticamente válido no pueda enviar un workflow que GitHub Actions se niegue a ejecutar. ÚSALA PARA: editar, añadir o revisar cualquier archivo bajo .github/workflows/, escribir valores de run-name/name/if/env/run que contengan expresiones ${{ }}, diagnosticar una ejecución que falla con 'This run likely failed because of a workflow file issue' y sin jobs…

Informe de la prueba

Se probó la instalación completa (git clone + cp literal, sin rescate), la separación de disparadores frente a las cláusulas explícitas USE FOR / DO NOT USE FOR / SCOPE del frontmatter, y una tarea de salida en A/B: redactar un workflow de pull_request cuyo run-name y valor de env incorporen ambos un '#' literal — la trampa exacta de truncamiento por comentario YAML que ataca esta skill creada por Microsoft. Tanto el brazo con skill como el base produjeron workflows sintácticamente válidos que entrecomillaron correctamente los dos escalares con '#', así que la skill no aportó aquí ninguna ventaja material de corrección (el brazo base evitó la trampa sin ayuda); la salida de la skill solo añadió una guarda condicional de estilo producción que la especificación no exigía. La documentación es precisa y no se sobrevende, pero un enlace dentro del cuerpo está roto — apunta a `.github/agents/agentic-workflows.agent.md` mientras que el archivo real es `agentic-workflows.md` — y el paso de descarga de actionlint fija un SHA-256 solo para el asset linux_amd64 (sin macOS/arm64).

Probado el: 2026-07-12 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/dotnet/skills
cd skills
mkdir -p ~/.claude/skills
cp -r .agents/skills/authoring-github-workflows ~/.claude/skills/authoring-github-workflows

Comandos y prompts de ejemplo

  • /authoring-github-workflowsRedacta y revisa YAML de GitHub Actions para que no pueda enviarse un workflow roto.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Write a GitHub Actions workflow for running tests
  • Fix why this workflow file won't start any jobs
  • Review this workflow YAML for quoting issues