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/jira-solve
tools
VerifiedTrustedCommunity
Analyze a JIRA issue and create a pull request to solve it. Use when the user wants to implement a fix or feature described in a Jira issue, push a branch, and open a draft PR.
112SKILL.mdUpdated Jul 29, 2026
openshift-eng/deep-review
development
VerifiedTrustedCommunity
Use when a deeper level of code review is requested. Multi-agent panel code review with specialist reviewers and forced runtime reproducers for all BLOCKING bug findings. Optionally posts to GitHub/GitLab as a PENDING review.
112SKILL.mdUpdated Jul 29, 2026
openshift-eng/review-docs
development
VerifiedTrustedCommunity
Review agentic documentation — verify claims locally against source code first, then use chai-bot for cross-repo and cross-functional verification
112SKILL.mdUpdated Jul 10, 2026
openshift-eng/prow-job-analysis
development
VerifiedTrustedCommunity
Use this skill when debugging a failed Prow CI job.
112SKILL.mdUpdated Jul 9, 2026