From microshift-release
Check if a given MicroShift version is available and where to find it
How this skill is triggered — by the user, by Claude, or both
Slash command
/microshift-release:release-versionsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
```bash
/microshift-release:release-versions <version>
The release-versions command checks if a specific MicroShift version is available and provides information about where to find RPMs and bootc images.
This command provides:
This command is useful for:
<ARGUMENTS> (version): The MicroShift version to check - Required
4.20.0, 4.18.264.21.0-ec.3 or 4.21.0~ec.34.20.0-rc.3 or 4.20.0~rc.34.21 (will check latest available)| Type | Version Format | Release Cadence | RPM Source | Image Source |
|---|---|---|---|---|
| Nightly | X.Y.0~0.nightly_YYYY_MM_DD_HHMMSS | Continuous | Brew | Not available |
| EC | X.Y.0~ec.N | Every sprint (3 weeks) | Brew, mirror repo | Mirror repo |
| RC | X.Y.0~rc.N | After branch cutoff until GA | Brew, mirror repo | Mirror repo |
| GA | X.Y.0 | Every 4 months | Brew, rhocp repos | registry.redhat.io |
| Z-stream | X.Y.Z | On request | Brew, rhocp repos | registry.redhat.io |
Goal: Parse the input version and classify its type.
Actions:
~ with - for URL construction)4.20 from 4.20.0-rc.3)nightly -> Nightly buildec -> Engineering Candidaterc -> Release CandidateX.Y.0 -> GA releaseX.Y.Z (Z > 0) -> Z-stream releaseExample:
Input: 4.21.0-ec.3
Parsed:
- normalized: 4.21.0-ec.3
- major_minor: 4.21
- type: EC
- base_version: 4.21.0
Goal: Check if OCP payload is Accepted for this version.
Actions:
Web Fetch this and look for the version:
https://openshift-release.apps.ci.l2s4.p1.openshiftapps.com/
Check if the payload for the version is Accepted.
Outcome:
Note: MicroShift packages become available when the corresponding OCP version is marked as "Accepted".
Goal: Determine if RPM packages are available and provide URLs.
Actions:
For EC versions:
Check mirror.openshift.com, EC packages are under ocp-dev-preview/, see:
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp-dev-preview/<version>/el9/os/Packages/
https://mirror.openshift.com/pub/openshift-v4/aarch64/microshift/ocp-dev-preview/<version>/el9/os/Packages/
Use WebFetch to verify the directory exists and list packages
For RC versions:
Check mirror.openshift.com, RC packages are under ocp/, see:
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp/<version>/el9/os/Packages/
https://mirror.openshift.com/pub/openshift-v4/aarch64/microshift/ocp/<version>/el9/os/Packages/
Use WebFetch to verify the directory exists and list packages
For GA/Z-stream versions:
Check on brew:
https://brewweb.engineering.redhat.com/brew/packageinfo?packageID=82827
Use this command to check for microshift releases:
curl -sk "https://brewweb.engineering.redhat.com/brew/search?match=glob&type=build&terms={version}" 2>/dev/null
Goal: Find bootc image pull specs for versions 4.18+.
Actions:
For EC versions:
Fetch bootc-pullspec.txt:
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp-dev-preview/<version>/el9/bootc-pullspec.txt
https://mirror.openshift.com/pub/openshift-v4/aarch64/microshift/ocp-dev-preview/<version>/el9/bootc-pullspec.txt
Extract the quay.io pull spec from the file
For RC versions:
Fetch bootc-pullspec.txt:
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp/<version>/el9/bootc-pullspec.txt
https://mirror.openshift.com/pub/openshift-v4/aarch64/microshift/ocp/<version>/el9/bootc-pullspec.txt
For GA/Z-stream versions:
https://catalog.redhat.com/en/software/containers/openshift4/microshift-bootc-rhel9/
Use this command to check the catalog:
curl -sk "https://catalog.redhat.com/api/containers/v1/repositories/registry/registry.access.redhat.com/repository/openshift4/microshift-bootc-rhel9/images?page_size=500&page=0" 2>/dev/null
https://catalog.stage.redhat.com/en/software/containers/openshift4/microshift-bootc-rhel9/
Use this command to check the catalog:
curl -sk "https://catalog.stage.redhat.com/api/containers/v1/repositories/registry/registry.access.redhat.com/repository/openshift4/microshift-bootc-rhel9/images?page_size=500&page=0" 2>/dev/null
Goal: If user provides a short version like 4.21, list all available sub-versions.
Actions:
Fetch directory listing from mirror.openshift.com:
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp-dev-preview/
https://mirror.openshift.com/pub/openshift-v4/x86_64/microshift/ocp/
Filter for versions matching the major.minor pattern
List all available versions with their types
Goal: Create a comprehensive availability report.
Report Structure:
# MicroShift Version Availability: <version>
## Status
- **Version**: <full-version>
- **Type**: EC / RC / GA / Z-stream
- **Status**: Available / Not Yet Available
- **OCP Release Status**: Accepted / Pending
## Brew Builds (VPN Required)
- **Web**: https://brewweb.engineering.redhat.com/brew/packageinfo?packageID=82827
- **Build**: <brew-build-nvr> (if found)
- **Status**: Available / Not Found / VPN Required
## RPM Packages
### x86_64
- **URL**: <mirror-url>
- **Status**: Available / Not Found
### aarch64
- **URL**: <mirror-url>
- **Status**: Available / Not Found
## Bootc Images (4.18+)
### x86_64
- **Pull Spec**: <quay.io/...@sha256:...>
### aarch64
- **Pull Spec**: <quay.io/...@sha256:...>
## Catalog Links
- [Red Hat Catalog](<catalog-url>) (GA/Z-stream only)
- [Stage Catalog](<stage-catalog-url>) (pre-GA Z-stream only)
## Notes
- <any relevant notes about availability>
/microshift-release:release-versions 4.21.0-ec.3
/microshift-release:release-versions 4.21.0-rc.1
/microshift-release:release-versions 4.18.26
/microshift-release:release-versions 4.21
Brew is Red Hat's internal build system. VPN is required to access it, assume VPN is enabled.
Web Interface:
Build NVR Format:
microshift-4.18.26-<release>.el9microshift-4.21.0-0.ec.3.<release>.el9microshift-4.21.0-0.rc.1.<release>.el9microshift-4.21.0-0.nightly_YYYY_MM_DD_HHMMSS.<release>.el9Mirror repos (EC/RC):
https://mirror.openshift.com/pub/openshift-v4/{ARCH}/microshift/ocp-dev-preview/{VERSION}/el9/os/Packages/https://mirror.openshift.com/pub/openshift-v4/{ARCH}/microshift/ocp/{VERSION}/el9/os/Packages/https://mirror.openshift.com/pub/openshift-v4/{ARCH}/microshift/ocp-dev-preview/{VERSION}/el9/bootc-pullspec.txthttps://mirror.openshift.com/pub/openshift-v4/{ARCH}/microshift/ocp/{VERSION}/el9/bootc-pullspec.txtRegistry repos (GA/Z-stream):
registry.redhat.io/openshift4/microshift-bootc-rhel9registry.stage.redhat.io/openshift4/microshift-bootc-rhel9Catalogs:
https://catalog.redhat.com/en/software/containers/openshift4/microshift-bootc-rhel9/https://catalog.stage.redhat.com/en/software/containers/openshift4/microshift-bootc-rhel9/Release versions are tested in CI:
test/scenarios/releases/ and test/scenarios-bootc/releases/test/bin/common_versions.sh when new RC or z-stream is availableGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub openshift-eng/edge-tooling --plugin microshift-release