feat: enhance globalhub-release skill with container validation and cross-platform support

- Add Docker/Podman availability verification before make update
- Add clear error messages when container engine is not available
- Add cross-platform sed syntax support (macOS and Linux)
- Remove container engine installation/initialization from script
- Update documentation with platform compatibility notes
- Improve error handling and user guidance

The skill now validates container engines upfront and provides clear
guidance without attempting automatic installation. The script automatically
detects the OS and uses appropriate sed syntax for both macOS and Linux.

Signed-off-by: Meng Yan <[email protected]>

Author: yanmxa

.claude/skills/globalhub-release/README.md

@@ -50,6 +50,14 @@ OPENSHIFT_RELEASE_PATH="$HOME/workspace/openshift-release" RELEASE_NAME="next" .
 3. **Fork**: You must have forked https://github.com/openshift/release to your account
 4. **Container engine**: Either Docker or Podman running (for `make update`)
 
+## Platform Support
+
+This skill and script are compatible with:
+- **macOS** (ARM/Apple Silicon and Intel)
+- **Linux** (x86_64)
+
+The script automatically detects the platform and uses the appropriate `sed` syntax.
+
 ## What This Skill Does
 
 1. ✅ Detects the latest release branch (e.g., release-2.15)
@@ -60,9 +68,10 @@ OPENSHIFT_RELEASE_PATH="$HOME/workspace/openshift-release" RELEASE_NAME="next" .
 6. ✅ Clones or reuses existing openshift/release repository
 7. ✅ Updates main branch CI configuration
 8. ✅ Creates new release pipeline configuration
-9. ✅ Auto-generates presubmits and postsubmits jobs
-10. ✅ Commits all changes with proper commit message
-11. ✅ Creates pull request to openshift/release
+9. ✅ **Verifies Docker/Podman availability before proceeding**
+10. ✅ Auto-generates presubmits and postsubmits jobs
+11. ✅ Commits all changes with proper commit message
+12. ✅ Creates pull request to openshift/release
 
 ## Version Mapping
 
@@ -99,17 +108,35 @@ The skill automatically calculates correct versions:
 ## Troubleshooting
 
 ### Container engine not running
-**Error**: `Cannot connect to the Docker daemon` or `podman: command not found`
 
-**Solution**: Start Docker Desktop or initialize podman:
-```bash
-# For Docker
-# Start Docker Desktop application
+**Error messages you might see:**
+```
+❌ Error: No container engine found!
+
+Please ensure Docker or Podman is installed and running.
+- Docker: Start Docker Desktop application
+- Podman: Ensure podman machine is running (podman machine start)
+```
 
-# For Podman
-podman machine init
-podman machine start
+Or:
 ```
+❌ Error: Podman is installed but no machine is running
+
+Please start your podman machine:
+   podman machine start
+```
+
+**Solution**:
+
+**For Docker:**
+- Start the Docker Desktop application
+- Verify it's running: `docker info`
+
+**For Podman:**
+- Start your podman machine: `podman machine start`
+- Verify it's running: `podman machine list`
+
+**Note**: This script assumes Docker or Podman is already installed and configured. It will not attempt to install or initialize container engines.
 
 ### Fork not found
 **Error**: `Fork not found`

.claude/skills/globalhub-release/SKILL.md

@@ -30,6 +30,14 @@ Automates the complete workflow for creating a new Multicluster Global Hub relea
 - `OPENSHIFT_RELEASE_PATH`: Local path for openshift/release repo (default: "/tmp/openshift-release")
 - `GITHUB_USER`: Auto-detected from git config
 
+## Platform Compatibility
+
+This workflow is compatible with:
+- **macOS** (ARM/Apple Silicon and Intel) - Uses `sed -i ""` syntax
+- **Linux** (x86_64) - Uses `sed -i` syntax
+
+The script automatically detects the OS and adjusts accordingly.
+
 ## Instructions
 
 ### Step 1: Detect Latest Release and Determine Next Version
@@ -147,16 +155,38 @@ sed -i "s/IMAGE_TAG: v1\.[0-9]\+\.0/IMAGE_TAG: ${GH_VERSION}/" \
   ci-operator/config/stolostron/multicluster-global-hub/stolostron-multicluster-global-hub-${NEXT_RELEASE}.yaml
 ```
 
-### Step 5: Auto-Generate Job Configurations
+### Step 5: Verify Container Engine and Auto-Generate Job Configurations
+
+**First, verify that a container engine is available:**
+
+```bash
+# Check for Docker
+if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
+  CONTAINER_ENGINE="docker"
+  echo "✅ Docker is available and running"
+# Check for Podman
+elif command -v podman >/dev/null 2>&1; then
+  if podman machine list 2>/dev/null | grep -q "Currently running"; then
+    CONTAINER_ENGINE="podman"
+    echo "✅ Podman is available and running"
+  else
+    echo "❌ Error: Podman is installed but no machine is running"
+    echo "Please start your podman machine: podman machine start"
+    exit 1
+  fi
+else
+  echo "❌ Error: No container engine found!"
+  echo "Please ensure Docker or Podman is installed and running"
+  exit 1
+fi
+```
 
-Use `make update` to automatically generate presubmits and postsubmits:
+**Then use `make update` to automatically generate presubmits and postsubmits:**
 
 ```bash
-# Check if docker is running, otherwise use podman
-if docker info >/dev/null 2>&1; then
+if [ "$CONTAINER_ENGINE" = "docker" ]; then
   CONTAINER_ENGINE=docker make update
 else
-  # Use podman (default)
   make update
 fi
 ```

.claude/skills/globalhub-release/scripts/create-release.sh

@@ -13,6 +13,15 @@ set -euo pipefail
 RELEASE_NAME="${RELEASE_NAME:-next}"
 OPENSHIFT_RELEASE_PATH="${OPENSHIFT_RELEASE_PATH:-/tmp/openshift-release}"
 
+# Detect OS and set sed in-place flag
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  # macOS requires -i with empty string
+  SED_INPLACE=(-i "")
+else
+  # Linux uses -i without argument
+  SED_INPLACE=(-i)
+fi
+
 echo "🚀 Starting Global Hub Release Branch Creation"
 echo "================================================"
 
@@ -123,41 +132,69 @@ NEW_CONFIG="ci-operator/config/stolostron/multicluster-global-hub/stolostron-mul
 
 # Update main branch configuration
 echo "   Updating main branch configuration..."
-sed -i.bak "s/name: \"${PREV_VERSION}\"/name: \"${VERSION}\"/" "$MAIN_CONFIG"
-sed -i.bak "s/DESTINATION_BRANCH: ${LATEST_RELEASE}/DESTINATION_BRANCH: ${NEXT_RELEASE}/" "$MAIN_CONFIG"
-rm -f "${MAIN_CONFIG}.bak"
+sed "${SED_INPLACE[@]}" "s/name: \"${PREV_VERSION}\"/name: \"${VERSION}\"/" "$MAIN_CONFIG"
+sed "${SED_INPLACE[@]}" "s/DESTINATION_BRANCH: ${LATEST_RELEASE}/DESTINATION_BRANCH: ${NEXT_RELEASE}/" "$MAIN_CONFIG"
 echo "   ✅ Updated $MAIN_CONFIG"
 
 # Create new release configuration
 echo "   Creating $NEXT_RELEASE pipeline configuration..."
 cp "$LATEST_CONFIG" "$NEW_CONFIG"
 
 # Update version references in new config
-sed -i.bak "s/name: \"${PREV_VERSION}\"/name: \"${VERSION}\"/" "$NEW_CONFIG"
-sed -i.bak "s/branch: ${LATEST_RELEASE}/branch: ${NEXT_RELEASE}/" "$NEW_CONFIG"
-sed -i.bak "s/release-${PREV_VERSION_SHORT}/release-${VERSION_SHORT}/g" "$NEW_CONFIG"
-sed -i.bak "s/IMAGE_TAG: v1\.[0-9]\+\.0/IMAGE_TAG: ${GH_VERSION}/" "$NEW_CONFIG"
-rm -f "${NEW_CONFIG}.bak"
+sed "${SED_INPLACE[@]}" "s/name: \"${PREV_VERSION}\"/name: \"${VERSION}\"/" "$NEW_CONFIG"
+sed "${SED_INPLACE[@]}" "s/branch: ${LATEST_RELEASE}/branch: ${NEXT_RELEASE}/" "$NEW_CONFIG"
+sed "${SED_INPLACE[@]}" "s/release-${PREV_VERSION_SHORT}/release-${VERSION_SHORT}/g" "$NEW_CONFIG"
+sed "${SED_INPLACE[@]}" "s/IMAGE_TAG: v1\.[0-9]\+\.0/IMAGE_TAG: ${GH_VERSION}/" "$NEW_CONFIG"
 echo "   ✅ Created $NEW_CONFIG"
 
-# Step 5: Auto-generate job configurations
+# Step 5: Verify container engine and auto-generate job configurations
+echo ""
+echo "📍 Step 5: Verifying container engine availability..."
+
+# Check for Docker
+if command -v docker >/dev/null 2>&1 && docker info >/dev/null 2>&1; then
+  CONTAINER_ENGINE="docker"
+  echo "   ✅ Docker is available and running"
+# Check for Podman
+elif command -v podman >/dev/null 2>&1; then
+  # Check if podman machine is running
+  if podman machine list 2>/dev/null | grep -q "Currently running"; then
+    CONTAINER_ENGINE="podman"
+    echo "   ✅ Podman is available and running"
+  else
+    echo "   ❌ Error: Podman is installed but no machine is running"
+    echo ""
+    echo "   Please start your podman machine:"
+    echo "      podman machine start"
+    echo ""
+    exit 1
+  fi
+else
+  echo "   ❌ Error: No container engine found!"
+  echo ""
+  echo "   Please ensure Docker or Podman is installed and running."
+  echo "   - Docker: Start Docker Desktop application"
+  echo "   - Podman: Ensure podman machine is running (podman machine start)"
+  echo ""
+  exit 1
+fi
+
 echo ""
-echo "📍 Step 5: Auto-generating job configurations..."
+echo "📍 Step 6: Auto-generating job configurations..."
 echo "   Running make update (this may take a few minutes)..."
+echo "   Using $CONTAINER_ENGINE as container engine..."
 
-if docker info >/dev/null 2>&1; then
-  echo "   Using Docker as container engine..."
+if [ "$CONTAINER_ENGINE" = "docker" ]; then
   CONTAINER_ENGINE=docker make update
 else
-  echo "   Using Podman as container engine..."
   make update
 fi
 
 echo "   ✅ Job configurations generated"
 
-# Step 6: Commit and create PR
+# Step 7: Commit and create PR
 echo ""
-echo "📍 Step 6: Committing changes and creating PR..."
+echo "📍 Step 7: Committing changes and creating PR..."
 
 # Check if there are changes
 if git diff --quiet && git diff --cached --quiet; then