What problem does it solve?
This Skill eliminates the time wasted guessing at CI pipeline failure causes by providing a systematic workflow to locate the exact failing job definition, reproduce the error locally, and map it to a clear root cause category.
Core Features & Use Cases
- Job Definition Location: Automatically finds the exact CI job definition across multi-file pipeline configurations, even when the root config only lists stages and includes.
- Local Reproduction Guidance: Walks you through running the exact failing job commands locally with the correct working directory and environment variables to replicate the CI error.
- Root Cause Categorization: Maps common CI failures (lint errors, test regressions, Terraform permission gaps, RBAC issues, stale artifacts) to their root cause and flags known external blockers before proposing fixes.
- Use Case: For example, if your Terraform plan stage fails in CI with an authorization error, this skill helps you reproduce the plan command locally, identify if the issue is a missing permission, code error, or drift, and tell you exactly what action to take.
Quick Start
Use the ci-pipeline-debug skill to diagnose why the failing 'terraform-plan' job in your GitLab CI pipeline is throwing an authorization error and tell me exactly what fix is needed.
