openshift-eng/fetch-releases
plugins/ci/skills/fetch-releases/SKILL.md
Fetch available OpenShift releases from the Sippy API
$ install --global
skillsauthnpx skillsauth add openshift-eng/ai-helpers fetch-releasesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 6:06 AM174.8s2 files scanned
SKILL.md
- name:
- fetch-releases
- description:
- Fetch available OpenShift releases from the Sippy API
Fetch Releases
This skill fetches the list of available OpenShift releases from the Sippy API. It can return all OCP releases or just the latest version.
When to Use This Skill
Use this skill when you need to:
- Determine the latest OCP release version
- Get a list of all available OCP releases
- Provide a default release version when the user hasn't specified one
Prerequisites
-
Python 3: Python 3.6 or later
- Check:
python3 --version - Uses only standard library (no external dependencies)
- Check:
-
Network Access: Must be able to reach the public Sippy API
- Check:
curl -s https://sippy.dptools.openshift.org/api/releases | head -c 100
- Check:
Implementation Steps
Step 1: Get the Latest Release
To get just the latest OCP release version:
release=$(python3 plugins/ci/skills/fetch-releases/fetch_releases.py --latest)
echo "$release"
# Output: 4.22
Step 2: List All Releases
To list all available OCP releases:
# JSON format (includes GA dates)
python3 plugins/ci/skills/fetch-releases/fetch_releases.py --format json
# Simple list, one per line
python3 plugins/ci/skills/fetch-releases/fetch_releases.py --format list
Step 3: Use with Other Skills
The primary use case is providing a default release to other skills:
# Determine release
release="${user_specified_release:-$(python3 plugins/ci/skills/fetch-releases/fetch_releases.py --latest)}"
# Use with fetch-test-report
python3 plugins/ci/skills/fetch-test-report/fetch_test_report.py "<test_name>" --release "$release"
Output Format
--latest
Prints a single release version string:
4.22
--format json (default)
[
{"release": "4.22"},
{"release": "4.21", "ga": "2025-06-17T00:00:00Z"},
{"release": "4.20", "ga": "2025-10-21T00:00:00Z"},
{"release": "4.19", "ga": "2025-06-17T00:00:00Z"}
]
Releases without a ga field are still in development.
--format list
4.22
4.21
4.20
4.19
4.18
Error Handling
- Network Error: If the Sippy API is unreachable, the script prints an error to stderr and exits with code 1.
- No Releases: If no standard OCP releases are found, exits with code 1.
Exit Codes:
0: Success1: Error
Notes
- Uses the public Sippy API at
https://sippy.dptools.openshift.org/api/releases(no port-forward needed) - Filters out non-standard releases (okd, aro, presubmits, etc.) — only returns releases matching
X.Yformat - The API returns releases in order with the latest first
- This skill is based on the same API as the
teamsplugin'sget-release-datesskill
See Also
- Related Skill:
fetch-test-report(uses release to query test data) - Related Skill (teams plugin):
get-release-dates(fetches detailed release dates and metadata)
Related Skills
openshift-eng/status-analysis
research
VerifiedTrustedCommunity
Shared engine for analyzing Jira issue activity and generating status summaries
98SKILL.mdUpdated Apr 28, 2026
openshift-eng/payload-snapshot
testing
VerifiedTrustedCommunity
Snapshot OpenShift payload data (release controller, PR diffs, comments, CI jobs, JUnit results, regression tracking) to a local directory for offline analysis
96SKILL.mdUpdated Jun 4, 2026
openshift-eng/payload-analysis
development
VerifiedTrustedCommunity
Analyze a payload snapshot to identify root causes of blocking job failures, score candidate PRs, and produce an HTML report with revert recommendations
96SKILL.mdUpdated Jun 4, 2026
openshift-eng/stage-payload-reverts
tools
VerifiedTrustedCommunity
Create TRT JIRA bugs, open revert PRs, and trigger payload jobs for high-confidence revert candidates
96SKILL.mdUpdated Apr 28, 2026