Does it help with permission and RBAC errors?

Yes, it includes investigation steps for ServiceAccounts, Roles, and RoleBindings to resolve 'Forbidden' or 'Unauthorized' errors during pipeline execution.

Can it help with pipelines that are stuck in a Pending state?

Yes, it includes diagnostic steps for resource exhaustion, such as checking namespace quotas, node capacity, and scheduling constraints.

How does it handle ImagePullBackOff errors?

The skill guides you through checking image names, registry authentication, and ServiceAccount secrets to identify exactly why a container image cannot be pulled.

What specifically does this skill help with in Konflux?

It provides a structured approach to debugging PipelineRun and TaskRun failures, covering everything from log retrieval to checking Kubernetes events and resource YAMLs.

What tools does this skill assume I have access to?

It primarily utilizes kubectl for interacting with the Kubernetes cluster where your Konflux pipelines are running.

Konflux Pipeline Debugger

Name: Konflux Pipeline Debugger
Author: konflux-ci

bykonflux-ci

•

デプロイメントとDevOps

Diagnoses and resolves failures in Konflux CI/CD pipelines by analyzing Tekton resources, logs, and Kubernetes events.

The Konflux Pipeline Debugger skill provides a systematic framework for troubleshooting complex CI/CD failures within the Konflux ecosystem. It guides developers through a multi-phase investigation process—from identifying failed TaskRuns and performing deep log analysis to correlating Kubernetes events and inspecting resource YAMLs. By addressing common failure patterns like ImagePullBackOff, OOMKilled errors, and workspace mounting issues, this skill helps users move beyond surface-level symptoms to identify and fix the root causes of Tekton pipeline bottlenecks and permission errors.

主な機能

01Deep log analysis for Tekton TaskRuns and individual container steps

02Systematic multi-phase troubleshooting workflow for CI/CD

03Decision trees for resolving stuck, failed, or timing-out pipelines

04Kubernetes event correlation for resource and scheduling issues

056 GitHub stars

06Diagnostic commands for PVC, RBAC, and resource quota inspection

ユースケース

01Investigating stuck or timing-out CI/CD pipelines in Konflux

02Debugging container-level errors like ImagePullBackOff or script exit codes

03Resolving resource constraints such as OOMKilled pods or namespace quota limits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add konflux-ci/skills debugging-pipeline-failures

For use in Claude.ai and ChatGPT

Download Skill