Where are the extracted files stored locally?

Files are stored in a local .work/prow-job-extract-must-gather/{build_id}/ directory, which is ignored by git to keep your repository clean.

What information do I need to provide to use this skill?

You only need to provide the GCSWeb URL for the Prow job that contains the test-platform-results/ path.

Can it handle nested archives within the must-gather?

Yes, it automatically detects and recursively decompresses nested .tar.gz, .tgz, and .gz files to provide a fully flattened view of the logs.

Does this skill require authentication to access CI logs?

No, the skill accesses the publicly available test-platform-results bucket, so gcloud authentication is typically not required for read access.

Prow Job Must-Gather Browser

Name: Prow Job Must-Gather Browser
Author: openshift-eng

byopenshift-eng

•

Deployment & DevOps

Extracts and decompresses OpenShift must-gather archives from Prow CI artifacts to generate an interactive, searchable HTML file browser.

This skill automates the tedious process of downloading and navigating complex, nested must-gather archives from Prow CI job results. It identifies build IDs from GCS URLs, fetches relevant artifacts, and recursively decompresses logs and configurations into a structured local directory. By generating a standalone HTML dashboard, it enables engineers to quickly filter by file type, search by filename, or use regex patterns to isolate issues within OpenShift cluster states, significantly reducing the time spent on manual log analysis.

Key Features

01Smart directory management with re-extraction options

02Classification of system logs, YAML manifests, and JSON data

0360 GitHub stars

04Interactive HTML file browser with real-time filtering and search

05Automatic recursive extraction of nested tar and gzip archives

06Automated parsing of Prow job URLs and build IDs

Use Cases

01Searching across thousands of log files for specific error patterns using regex

02Analyzing OpenShift cluster state from failed CI test runs

03Auditing cluster configurations and certificates without manual downloads

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add openshift-eng/ai-helpers prow-job-extract-must-gather

For use in Claude.ai and ChatGPT

Download Skill