[andre-motta]

Summary

The upstream auto-merge failed with a conflict in skills/debug-openshell-cluster/SKILL.md (rhods-devops-infra run 39951574868). Midstream carried an ODH installer block inside that upstream-owned file, and an earlier sync merge kept a stale midstream table row, so upstream NVIDIA#4702 conflicted with it. This moves the ODH guidance into a midstream-only skill and makes debug-openshell-cluster identical to upstream so future syncs merge it cleanly.

Related Issue

The target repository (opendatahub-io/openshell) has GitHub Issues disabled, so there is no target-repository issue to close.

Changes

• Reset skills/debug-openshell-cluster/SKILL.md to the upstream merge-base version (132c582). This also restores the SCC troubleshooting row from upstream chore(e2e): remove obsolete OpenShift sandbox SCC grant NVIDIA/OpenShell#4823 that sync merge c2830aa dropped.
• Add skills/debug-odh-openshell-install/SKILL.md with the ODH gateway-and-dashboard installer guidance, unchanged, plus a pointer back to debug-openshell-cluster.

Testing

• Simulated merge of upstream/main (9a85667) into this branch completes without conflicts
• After the simulated merge, SKILL.md matches upstream/main
• markdownlint-cli2 and scripts/update_license_headers.py --check pass

Checklist

• Follows Conventional Commits
• Commits are signed off (DCO)
• Architecture docs updated (if applicable)

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Added troubleshooting guidance for ODH/RHOAI OpenShell gateway and dashboard installations, covering installation state, credentials, Routes, login, and sandbox readiness.
  • Updated sandbox startup guidance to address UID/GID range conflicts and incompatible security-context overrides, replacing the previous privileged SCC recommendation.
  • Moved ODH/RHOAI installation troubleshooting details out of the general OpenShell cluster guide; it now focuses on cluster and sandbox startup issues.

[coderabbitai]

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Central YAML (base), Organization UI (inherited)
• Review profile: CHILL
• Plan: Enterprise
• Run ID: 55614aaa-d731-4af5-90f1-baa7151d5e4c

📥 Commits

Reviewing files that changed from the base of the PR and between 60e6434 and 6b32278.

📒 Files selected for processing: 2

• skills/debug-odh-openshell-install/SKILL.md
• skills/debug-openshell-cluster/SKILL.md

+----------------------------------------------------------------------------------------------------------------------------------------+
| Use saboteurs to test your testing. Introduce bugs on purpose in a separate copy of the source to verify that testing will catch them. |
+----------------------------------------------------------------------------------------------------------------------------------------+
  \
   \     /)/)
        ( '')
        /  |
      o(___)

_{Comment @coderabbitai help to get the list of available commands.}