gitlab-cicd-debug

Diagnose GitLab CI/CD pipeline failures, including Vault JWT and Docker build errors.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/zach-source/claude-plugins --skill gitlab-cicd-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitlab-cicd-debug
Source: https://github.com/zach-source/claude-plugins/tree/main/plugins/devops/skills/gitlab-cicd-debug
Command: npx skills add https://github.com/zach-source/claude-plugins --skill gitlab-cicd-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve common issues encountered during GitLab CI/CD pipeline execution, reducing downtime and improving deployment reliability.

Core Features & Use Cases

  • Troubleshoot Auth Failures: Addresses problems with Vault JWT authentication and AWS/ECR credentials.
  • Diagnose Build/Deploy Errors: Provides guidance for Docker build issues and Kubernetes deployment failures.
  • Use Case: When a critical deployment pipeline fails due to a Vault authentication error, this Skill can help identify the specific Vault role, bound claims, and required policies to fix the issue.

Quick Start

Use the gitlab-cicd-debug skill to help debug a pipeline job that failed with a "permission denied" error related to Vault authentication.

Frequently Asked Questions about gitlab-cicd-debug

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

FAQPage Schema
How do I debug GitLab CI/CD pipeline failures with Vault JWT authentication errors?

To debug GitLab CI/CD pipeline failures with Vault JWT authentication, this Skill identifies the specific Vault role, bound claims, and required policies to resolve permission denied errors. It analyzes pipeline job logs to pinpoint authentication misconfigurations.

What is the best way to troubleshoot AWS/ECR credential issues in a GitLab CI/CD pipeline?

Troubleshooting AWS/ECR credential issues in a GitLab CI/CD pipeline involves analyzing job logs to identify error categories and applying specific command-line solutions and configuration examples to fix authentication blockers.

How do I fix Docker build errors during my GitLab CI/CD deployment?

To fix Docker build errors during GitLab CI/CD deployment, this Skill scopes troubleshooting to pipeline job logs, identifies the failure pattern, and provides specific command-line solutions and configuration examples to resolve the build issue.

Why does my Kubernetes deployment fail in GitLab CI/CD and how can I resolve it?

Your Kubernetes deployment may fail in GitLab CI/CD due to configuration or connectivity issues. This Skill diagnoses these deployment failures by troubleshooting pipeline job logs and providing targeted command-line solutions to improve pipeline stability.

Can I use this to find specific command-line solutions for GitLab CI/CD pipeline job failures?

Yes, you can use this to find specific command-line solutions for GitLab CI/CD pipeline job failures. It identifies error categories from job logs and provides specific configuration examples to resolve common deployment blockers.