docs: update SKILL.md files to reference Python scripts

Replace bash invocations with python/uv run for the new .py scripts.
Update Prerequisites from yq/jq/curl to Python 3.9+.

Assisted-by: OpenCode

Author: zdrapela

skills/lifecycle-aks/SKILL.md

@@ -18,22 +18,23 @@ description: >-
 
 ## Prerequisites
 
-- `curl`, `jq`, `yq` (v4+), internet connectivity
+- Python 3.9+, internet connectivity
 - For configured version display: local `openshift/release` checkout or `gh` CLI
 
 ## Steps
 
 1. Run the lifecycle check script:
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-aks-lifecycle.sh" \
+uv run "${SKILL_DIR}/scripts/check_aks_lifecycle.py" \
   --mapt-ref ci-operator/step-registry/redhat-developer/rhdh/aks/mapt/create/redhat-developer-rhdh-aks-mapt-create-ref.yaml \
   --test-pattern "^e2e-aks-"
 ```
 
 The script auto-detects whether you're in an `openshift/release` checkout or uses the GitHub API for remote access. Override with `--repo-dir <path>`.
 
 The script queries two sources:
+
 - **Primary**: `https://releases.aks.azure.com/parsed_data.json` -- official AKS release status with per-region K8s version availability (major.minor only)
 - **Cross-verify**: `https://endoflife.date/api/azure-kubernetes-service.json` -- community-maintained EOL dates
 

skills/lifecycle-eks/SKILL.md

@@ -19,22 +19,23 @@ description: >-
 
 ## Prerequisites
 
-- `curl`, `jq`, `yq` (v4+), `awk`, internet connectivity
+- Python 3.9+, internet connectivity
 - For configured version display: local `openshift/release` checkout or `gh` CLI
 
 ## Steps
 
 1. Run the lifecycle check script:
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-eks-lifecycle.sh" \
+uv run "${SKILL_DIR}/scripts/check_eks_lifecycle.py" \
   --mapt-ref ci-operator/step-registry/redhat-developer/rhdh/eks/mapt/create/redhat-developer-rhdh-eks-mapt-create-ref.yaml \
   --test-pattern "^e2e-eks-"
 ```
 
 The script auto-detects whether you're in an `openshift/release` checkout or uses the GitHub API for remote access. Override with `--repo-dir <path>`.
 
 The script queries two sources:
+
 - **Primary**: `awsdocs/amazon-eks-user-guide` raw AsciiDoc on GitHub -- official AWS EKS docs source with standard/extended support status and release calendar
 - **Cross-verify**: `https://endoflife.date/api/amazon-eks.json` -- community-maintained EOL dates
 

skills/lifecycle-gke/SKILL.md

@@ -19,17 +19,18 @@ GKE uses a pre-existing long-running cluster. The K8s version is NOT in CI confi
 
 ## Prerequisites
 
-- `curl`, `jq`, internet connectivity
+- Python 3.9+, internet connectivity
 
 ## Steps
 
 1. Run the lifecycle check script:
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-gke-lifecycle.sh"
+python "${SKILL_DIR}/scripts/check_gke_lifecycle.py"
 ```
 
 The script queries:
+
 - **Primary**: `https://endoflife.date/api/google-kubernetes-engine.json` -- auto-scraped from Google's GKE release schedule page, shows standard/maintenance support status and EOL dates
 
 2. If the API call fails, fall back to the vendor docs:

skills/lifecycle-ocp/SKILL.md

@@ -8,47 +8,49 @@ description: >-
 # Check RHDH and OCP Lifecycle Status
 
 Query the Red Hat Product Life Cycles API to determine:
+
 - Which RHDH releases are currently supported (Full Support or Maintenance)
 - Which OCP versions each active RHDH release supports
 - Which OCP versions are still supported upstream (including EUS phases)
 
 ## When to Use
 
 Use this skill when you need to check version support status before:
+
 - Adding or removing RHDH cluster pools
 - Adding or removing OCP-versioned CI test entries
 - Planning RHDH release branch OCP coverage
 - Running the `prow-ocp-coverage` analysis skill
 
 ## Prerequisites
 
-- `curl` and `jq` must be available
+- Python 3.9+
 - Internet connectivity to reach `https://access.redhat.com`
 
 ## Usage
 
 Run the bundled script:
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-ocp-lifecycle.sh"
+python "${SKILL_DIR}/scripts/check_ocp_lifecycle.py"
 ```
 
 ### Check a specific OCP version
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-ocp-lifecycle.sh" --version 4.16
+python "${SKILL_DIR}/scripts/check_ocp_lifecycle.py" --version 4.16
 ```
 
 ### Check a specific RHDH version
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-ocp-lifecycle.sh" --rhdh-version 1.9
+python "${SKILL_DIR}/scripts/check_ocp_lifecycle.py" --rhdh-version 1.9
 ```
 
 ### Show only RHDH lifecycle (skip OCP table)
 
 ```bash
-bash "${SKILL_DIR}/scripts/check-ocp-lifecycle.sh" --rhdh-only
+python "${SKILL_DIR}/scripts/check_ocp_lifecycle.py" --rhdh-only
 ```
 
 ## Output
@@ -68,6 +70,7 @@ Shows each RHDH release with:
 | SUPPORTED_OCP_VERSIONS | OCP versions this RHDH release officially supports |
 
 After the table, a summary shows:
+
 - The union of OCP versions supported across all active RHDH releases
 - Per-release OCP support breakdown
 
@@ -89,6 +92,7 @@ The **RHDH_SUPP** column is the key indicator for CI coverage decisions. An OCP
 ### JSON Summary (stderr)
 
 A JSON object is written to stderr with:
+
 - `rhdh_supported_versions`: Array of active RHDH releases with their OCP compatibility
 - `ocp_versions_supported_by_rhdh`: Deduplicated array of OCP versions supported by any active RHDH release
 

skills/prow-aks-jobs/SKILL.md

@@ -19,26 +19,26 @@ List AKS test entries and update the K8s version used by AKS MAPT clusters.
 
 ## Prerequisites
 
-- `yq` (v4+) for listing tests
+- Python 3.9+
 - Works from any directory (auto-detects local checkout or uses GitHub API)
 - For updating versions: requires a local `openshift/release` checkout
 
 ## Listing Tests
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-aks-jobs.sh"
+uv run "${SKILL_DIR}/scripts/list_aks_jobs.py"
 ```
 
 ### Filter by branch
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-aks-jobs.sh" --branch main
+uv run "${SKILL_DIR}/scripts/list_aks_jobs.py" --branch main
 ```
 
 ### Override repo location
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-aks-jobs.sh" --repo-dir /path/to/openshift/release
+uv run "${SKILL_DIR}/scripts/list_aks_jobs.py" --repo-dir /path/to/openshift/release
 ```
 
 ## Updating the Version (requires local checkout)

skills/prow-eks-jobs/SKILL.md

@@ -19,26 +19,26 @@ List EKS test entries and update the K8s version used by EKS MAPT clusters.
 
 ## Prerequisites
 
-- `yq` (v4+) for listing tests
+- Python 3.9+
 - Works from any directory (auto-detects local checkout or uses GitHub API)
 - For updating versions: requires a local `openshift/release` checkout
 
 ## Listing Tests
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-eks-jobs.sh"
+uv run "${SKILL_DIR}/scripts/list_eks_jobs.py"
 ```
 
 ### Filter by branch
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-eks-jobs.sh" --branch main
+uv run "${SKILL_DIR}/scripts/list_eks_jobs.py" --branch main
 ```
 
 ### Override repo location
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-eks-jobs.sh" --repo-dir /path/to/openshift/release
+uv run "${SKILL_DIR}/scripts/list_eks_jobs.py" --repo-dir /path/to/openshift/release
 ```
 
 ## Updating the Version (requires local checkout)

skills/prow-gke-jobs/SKILL.md

@@ -20,25 +20,25 @@ a pre-existing static cluster. Version upgrades are performed via the GCP Consol
 
 ## Prerequisites
 
-- `yq` (v4+) for listing tests
+- Python 3.9+
 - Works from any directory (auto-detects local checkout or uses GitHub API)
 
 ## Listing Tests
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-gke-jobs.sh"
+uv run "${SKILL_DIR}/scripts/list_gke_jobs.py"
 ```
 
 ### Filter by branch
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-gke-jobs.sh" --branch main
+uv run "${SKILL_DIR}/scripts/list_gke_jobs.py" --branch main
 ```
 
 ### Override repo location
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-gke-jobs.sh" --repo-dir /path/to/openshift/release
+uv run "${SKILL_DIR}/scripts/list_gke_jobs.py" --repo-dir /path/to/openshift/release
 ```
 
 ## Cluster Version Management

skills/prow-ocp-coverage/SKILL.md

@@ -12,20 +12,22 @@ Cross-reference RHDH cluster pools, CI test configurations, RHDH lifecycle data,
 ## When to Use
 
 Use this skill when you need to:
+
 - Check if RHDH CI coverage matches the current RHDH-supported OCP versions
 - Find OCP versions that RHDH no longer supports but still have active pools or test entries
 - Find RHDH-supported OCP versions missing cluster pools or test entries
 - Plan OCP version additions or removals for a new RHDH release
 
 ## Prerequisites
 
-- `curl`, `jq`, and `yq` (v4+) must be available
+- Python 3.9+
 - Internet connectivity to reach `https://access.redhat.com`
 - Works from any directory (auto-detects local `openshift/release` checkout or uses GitHub API)
 
 ## Composed Skills
 
 This skill composes data from:
+
 - **`lifecycle-ocp`**: RHDH and OCP version lifecycle data (via shared `ocp-lifecycle.jq`)
 - **`prow-ocp-pools`**: Cluster pool configurations
 - **`prow-ocp-jobs`**: CI test entry configurations
@@ -35,13 +37,13 @@ This skill composes data from:
 Run the bundled analysis script:
 
 ```bash
-bash "${SKILL_DIR}/scripts/analyze-coverage.sh"
+uv run "${SKILL_DIR}/scripts/analyze_coverage.py"
 ```
 
 ### Override repo location
 
 ```bash
-bash "${SKILL_DIR}/scripts/analyze-coverage.sh" --repo-dir /path/to/openshift/release
+uv run "${SKILL_DIR}/scripts/analyze_coverage.py" --repo-dir /path/to/openshift/release
 ```
 
 ## Two Dimensions of Support
@@ -54,6 +56,7 @@ The analysis checks two independent dimensions for each OCP version:
 | **RHDH supported** | RHDH lifecycle API (`openshift_compatibility` field) | RHDH officially supports running on this OCP version |
 
 An OCP version must satisfy **both** to warrant a cluster pool and test entry:
+
 - An OCP-EOL version should always be removed (regardless of RHDH compatibility)
 - An OCP-supported but non-RHDH-supported version should be reviewed
 

skills/prow-ocp-jobs/SKILL.md

@@ -12,14 +12,15 @@ Manage OCP-specific test entries in RHDH ci-operator configuration files. This s
 ## When to Use
 
 Use this skill when you need to:
+
 - List which OCP versions have helm-nightly test entries per RHDH release branch
 - Add a new OCP version test entry to a config file
 - Remove an end-of-life OCP version test entry from a config file
 - Generate a test entry YAML block for review before adding it
 
 ## Prerequisites
 
-- `yq` (v4+) must be available for YAML parsing
+- Python 3.9+
 - For listing: works from any directory (auto-detects local checkout or uses GitHub API)
 - For generating/adding/removing: requires a local `openshift/release` checkout
 
@@ -38,19 +39,19 @@ Use this skill when you need to:
 Run the bundled script (works from any directory):
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-ocp-test-configs.sh"
+uv run "${SKILL_DIR}/scripts/list_ocp_test_configs.py"
 ```
 
 ### Filter by product branch
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-ocp-test-configs.sh" --branch main
+uv run "${SKILL_DIR}/scripts/list_ocp_test_configs.py" --branch main
 ```
 
 ### Override repo location
 
 ```bash
-bash "${SKILL_DIR}/scripts/list-ocp-test-configs.sh" --repo-dir /path/to/openshift/release
+uv run "${SKILL_DIR}/scripts/list_ocp_test_configs.py" --repo-dir /path/to/openshift/release
 ```
 
 ### Output format
@@ -72,13 +73,13 @@ e2e-ocp-v4-19-helm-nightly                     4.19          0 5 * * TUE,THU,SAT
 Use the bundled script to generate a new test entry YAML block:
 
 ```bash
-bash "${SKILL_DIR}/scripts/generate-test-entry.sh" --version 4.22 --branch main
+uv run "${SKILL_DIR}/scripts/generate_test_entry.py" --version 4.22 --branch main
 ```
 
 ### With a specific reference version
 
 ```bash
-bash "${SKILL_DIR}/scripts/generate-test-entry.sh" --version 4.22 --branch main --reference 4.21
+uv run "${SKILL_DIR}/scripts/generate_test_entry.py" --version 4.22 --branch main --reference 4.21
 ```
 
 The script outputs a ready-to-insert YAML block based on an existing versioned test entry with all version-specific values substituted.
@@ -123,13 +124,15 @@ make update
 ```
 
 This regenerates:
+
 - Prow job configs in `ci-operator/jobs/`
 - `zz_generated_metadata` sections
 - Other downstream artifacts
 
 ## File Layout
 
 CI config files live in:
+
 ```
 ci-operator/config/redhat-developer/rhdh/
 ├── redhat-developer-rhdh-main.yaml
@@ -138,6 +141,7 @@ ci-operator/config/redhat-developer/rhdh/
 ```
 
 Generated Prow jobs go to:
+
 ```
 ci-operator/jobs/redhat-developer/rhdh/
 ├── redhat-developer-rhdh-main-presubmits.yaml