pipeline-fix

Diagnose failed GitLab CI/CD pipelines and fix failing jobs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/led8/.codex --skill pipeline-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pipeline-fix
Source: https://github.com/led8/.codex/tree/main/skills/pipeline-fix
Command: npx skills add https://github.com/led8/.codex --skill pipeline-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides a developer or maintainer through diagnosing failed GitLab CI/CD pipelines, locating failing jobs and root causes in job logs, applying targeted fixes to code, dependencies, or CI configuration, and verifying the pipeline after changes.

Core Features & Use Cases

  • Systematic diagnosis: Identify the relevant MR or branch pipeline, enumerate jobs, and retrieve failing job traces using glab or the GitLab API.
  • Targeted remediation patterns: Fix dependency version mismatches, Docker build errors, test and lint failures, and CI configuration issues with clear edit-commit-verify steps.
  • Use Case: Resolve a Renovate bot MR whose docker-build job fails because a system package version is unavailable by updating the Dockerfile, committing the change, and monitoring the new pipeline run.

Quick Start

Use the pipeline-fix skill to analyze MR 88's failed pipeline, identify the failing job and error, apply a minimal fix in the source branch, commit with a conventional message, and push to trigger a new pipeline.

Frequently Asked Questions about pipeline-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a failed GitLab CI/CD pipeline?

To fix a failed GitLab CI/CD pipeline, diagnose failing jobs and retrieve their traces using glab or the GitLab API, apply targeted fixes to dependencies or CI configuration, then commit and push to trigger verification.

How do I debug GitLab CI job logs to find the root cause of a pipeline failure?

Debug GitLab CI job logs by identifying the relevant merge request or branch pipeline, enumerating jobs, and retrieving the specific failing job traces to inspect errors and locate the exact root cause.

Can I use glab to troubleshoot failed Renovate bot merge requests in GitLab?

Yes, you can troubleshoot failed Renovate bot merge requests by reading pipeline and job logs via glab, identifying dependency version errors, and applying targeted fixes like updating the Dockerfile to resolve the build failure.

What permissions do I need to read GitLab pipeline logs and push CI fixes?

You need GitLab project access via glab or the API with permissions to read pipeline and job logs and to push fixes to the source repository branch to remediate CI failures.

What types of CI failures can be resolved by inspecting GitLab pipeline logs?

Inspecting GitLab pipeline logs helps resolve dependency version mismatches, Docker build errors, test and lint failures, and CI configuration issues by guiding clear edit-commit-verify steps for the source branch.