skills.rest
konflux-ci
konflux-ciOFFICIAL
Explore all skills by this author →
GitHub

navigating-github-to-konflux-pipelines

Extract and parse Konflux PipelineRun URLs from GitHub checks for kubectl debugging.

8|12|Updated Nov 7, 2025
Search Tags:#debugging#github#pipeline#kubectl#konflux#pipelineRun
One-click install
npx skills add https://github.com/konflux-ci/skills --skill navigating-github-to-konflux-pipelines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: navigating-github-to-konflux-pipelines
Source: https://github.com/konflux-ci/skills/tree/main/skills/navigating-github-to-konflux-pipelines
Command: npx skills add https://github.com/konflux-ci/skills --skill navigating-github-to-konflux-pipelines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill helps automate the process of identifying Konflux-related checks on GitHub, extracting PipelineRun URLs, and parsing those URLs for kubectl debugging. It empowers engineers to quickly move from a failing PR check to a kubectl-ready debugging workflow.

Core Features & Use Cases

  • Filter checks by the Konflux pattern (name or details URL containing konflux)
  • Extract direct PipelineRun URLs from build checks (-on-pull-request / -on-push)
  • Parse PipelineRun URLs into cluster, namespace, and PipelineRun name for kubectl
  • Distinguish build vs integration-test checks and prepare diagnostic steps

Quick Start

Use the skill to locate Konflux checks on PRs, then extract and parse the PipelineRun URL for kubectl debugging. Example: given a PR with failing Konflux checks, run the commands to obtain the PipelineRun URL and parse cluster/namespace/run.

Frequently Asked Questions about navigating-github-to-konflux-pipelines

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

FAQPage Schema
How do I find Konflux pipeline checks when a GitHub PR fails?▼

Identify Konflux pipeline checks by filtering GitHub checks for names or URLs containing 'konflux'. This Skill extracts check details to locate associated PipelineRun URLs from PR or branch failures, enabling rapid navigation from GitHub to pipeline debugging.

How do I extract a PipelineRun URL from a Konflux check and parse it for kubectl?▼

Extract the PipelineRun URL from build checks (-on-pull-request or -on-push), then parse it to obtain cluster, namespace, and PipelineRun name. These values feed directly into kubectl commands for cluster-level pipeline debugging and log inspection.

Can I distinguish between Konflux build checks and integration-test checks?▼

Yes, this Skill filters and separates build checks (those with -on-pull-request or -on-push suffixes) from integration-test checks. This distinction guides which diagnostic steps and kubectl workflows apply to your failure scenario.

What do I need installed to use this Skill for GitHub and kubectl workflows?▼

You need gh (GitHub CLI) and jq (JSON query tool) installed. These dependencies enable the Skill to query GitHub checks programmatically and parse PipelineRun URLs into cluster and namespace data for kubectl access.

How do I automate Konflux check filtering and PipelineRun URL extraction?▼

Use the provided wrapper script with gh commands to automate filtering checks by Konflux pattern, extracting PipelineRun URLs, and parsing cluster and namespace data. This produces programmatic output for downstream kubectl workflows without manual URL inspection.

Does this work for main-branch pipeline failures and integration-test failures?▼

Yes, this Skill applies to PR failures, main-branch failures, and integration-test failures. It identifies Konflux checks across all three contexts and extracts PipelineRun data to enable consistent kubectl-based debugging regardless of failure source.

Related Skills

Explore More Software Engineering Skills→
bkircherbkircher
11

gh-run-failure

Analyze GitHub Actions run failures by inspecting job outcomes and step logs.

Community
Intermediate
konflux-cikonflux-ci
8

debugging-pipeline-failures

Diagnose Konflux Tekton pipeline failures using kubectl and Tekton CLI.

Official
Advanced
kubiyabotkubiyabot
16

kubernetes

Execute kubectl commands to manage Kubernetes clusters.

Official
Advanced
konflux-cikonflux-ci
8

Konflux is a build tool

Query Konflux objects and logs across Kubernetes/OpenShift to diagnose build and deployment issues.

Official
Advanced