gh-fix-ci

What it does

This skill enables AI agents to automatically diagnose and repair broken GitHub Actions CI/CD pipelines. It analyzes workflow files to identify syntax errors, logic flaws, or dependency issues that prevent successful builds.

When to use it

• Automated Recovery: Trigger immediately after a failed build notification to restore deployment continuity without manual intervention.
• PR Validation: Run against pull request changes before merging to catch pipeline-breaking modifications early.
• Legacy Migration: Use when refactoring workflows from older GitHub Actions versions to ensure compatibility with current runners.
• Dependency Updates: Apply after updating core actions or dependencies that might introduce breaking changes to the workflow logic.

Key capabilities

• Parses .github/workflows/*.yml files for structural integrity.
• Detects common errors such as missing jobs, invalid steps, or incorrect environment variables.
• Generates corrected workflow configurations based on detected issues.
• Integrates directly with the GitHub Actions ecosystem for seamless execution.

Example prompts

• "Run gh-fix-ci on my repository to identify why the last deployment failed."
• "Analyze the deploy.yml file and apply gh-fix-ci to correct any syntax errors found."
• "Before I merge this PR, use gh-fix-ci to validate that the CI pipeline will still run successfully."

Tips & gotchas

Ensure your repository has write permissions for GitHub Actions workflows; otherwise, the agent cannot save corrected files. This skill focuses on code-level fixes and may not resolve complex infrastructure issues like runner capacity limits or external API rate limits.