skills.rest
openshift-eng
openshift-engOFFICIAL
Explore all skills by this author →
WebsiteGitHub

Prow Job Extract Must-Gather

Extract and decompress nested must-gather archives from Prow CI job artifacts.

112|305|Updated Oct 10, 2025
Search Tags:#debugging#CI/CD#logs#analysis#Kubernetes#Prow#must-gather
One-click install
npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-extract-must-gather
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Prow Job Extract Must-Gather
Source: https://github.com/openshift-eng/ai-helpers/tree/main/plugins/prow-job/skills/prow-job-extract-must-gather
Command: npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-extract-must-gather

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? Manually downloading and recursively extracting nested must-gather archives from Prow CI jobs is time-consuming and error-prone. This skill automates the entire process, providing an interactive HTML browser for quick analysis.

Core Features & Use Cases

  • Automated Archive Extraction: Handles nested .tar.gz, .tgz, and .gz archives, simplifying complex data retrieval.
  • Interactive HTML File Browser: Generates a modern, filterable, and searchable HTML interface for browsing extracted files.
  • Smart Directory Renaming: Renames long, auto-generated directories to a concise "content/" for better readability.
  • Use Case: When a Prow CI job fails, simply provide the job URL. This skill will download, extract, and present all must-gather logs in an interactive browser, allowing you to quickly pinpoint issues without manual decompression.

Quick Start

Example: Extract must-gather from a Prow job URL

User: "Extract must-gather from https://gcsweb-ci.apps.ci.l2s4.p1.openshiftapps.com/gcs/test-platform-results/logs/periodic-ci-openshift-release-master-ci-4.20-e2e-aws-ovn-techpreview/1965715986610917376"

Frequently Asked Questions about Prow Job Extract Must-Gather

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

FAQPage Schema
How do I extract must-gather archives from Prow CI job failures?▼

Extract must-gather archives by providing a Prow job URL. The Skill downloads the must-gather.tar from the job artifacts via gcloud, recursively decompresses nested .tar.gz, .tgz, and .gz files up to 10 levels deep, and generates an interactive HTML browser for immediate log analysis without manual decompression.

Can I browse and search must-gather logs without manual extraction?▼

Yes. The Skill generates a searchable, filterable HTML interface with file-type filters to navigate extracted must-gather contents. Long auto-generated directory names are renamed to 'content/' for readability, enabling quick pinpointing of issues in CI/CD logs.

What happens when Prow job artifacts contain deeply nested or multiple compressed archives?▼

The Skill handles nested archives automatically up to 10 levels deep, decompressing .tar.gz, .tgz, and .gz formats in sequence. It validates prowjob.json to locate the target must-gather.tar and extracts all levels without user intervention.

Does this work with Kubernetes debugging and CI/CD log analysis workflows?▼

Yes. The Skill is purpose-built for Prow CI jobs running on Kubernetes clusters. It automates must-gather extraction and report generation, integrating directly into OpenShift CI/CD debugging workflows to accelerate root-cause analysis.

What dependencies or external tools are required to extract and browse must-gather?▼

None. The Skill uses only Python standard libraries with no external dependencies, requiring only gcloud for artifact download and a web browser to view the generated HTML report.

What data does the Skill provide after extraction?▼

The Skill generates extraction statistics, a validated prowjob.json reference, and a browsable HTML report containing all decompressed must-gather logs organized by file type with search and filtering capabilities.

Related Skills

Explore More Software Engineering Skills→
openshift-engopenshift-eng

Prow Job Artifact Search

Search and retrieve Prow CI job artifacts from the test-platform-results GCS bucket.

Official
Intermediate
incidentfoxincidentfox
654

alerting-context

Fetch on-call rosters, incident history, and MTTR metrics from PagerDuty.

Official
Intermediate
openshift-engopenshift-eng

Analyze Disruption

Aggregate interval data, audit logs, and pod logs to identify disruption root causes.

Official
Advanced
huynguyenhhuynguyenh
3

hnh-k8s

Run kubectl commands to debug and monitor Kubernetes EKS clusters.

Community
Intermediate