Add openhands-enterprise-troubleshooting skill for OHE self-hosted debugging

[jpelletier1]

Overview

Add a new skill for diagnosing and resolving common issues on OpenHands Enterprise (OHE) self-hosted installations using Replicated VM-based infrastructure.

What This Skill Does

1. Triage and Diagnosis

• Detects failure modes from symptoms or log output
• Checks common problem areas: sandbox startup, auth, certificates, LLM connectivity, Keycloak, Replicated Admin Console, upgrades, resource exhaustion
• Runs targeted diagnostic commands against the live environment

2. Guided Recovery

• Walks through resolution steps for identified issues
• Validates each step before proceeding
• Covers the 8 most common failures:
  • Sandbox fails to start / 120s timeout
  • Git provider auth broken (GitHub App, GitLab token)
  • Certificate errors (self-signed, expired, chain issues)
  • LLM connectivity failures (endpoint unreachable, bad credentials)
  • Keycloak login issues
  • Replicated Admin Console unreachable
  • Upgrade stuck or failed
  • OOM / resource exhaustion on the VM

3. Support Bundle Generation

• Guides customers through generating and sending support bundles
• Parses and summarizes bundle output to highlight likely root cause

4. Escalation Handoff

• Produces a clear summary when issues cannot be resolved
• Documents what was tried, what logs show, and likely root cause

Files Added

• skills/openhands-enterprise-troubleshooting/SKILL.md - Main skill
• skills/openhands-enterprise-troubleshooting/references/diagnostics.md - Detailed diagnostic commands
• skills/openhands-enterprise-troubleshooting/README.md - Human-facing documentation

Use Cases

This skill is for:

• Customers self-serving on their self-hosted OHE infrastructure
• FDEs during support calls
• First-response step before escalating to the platform team

Reference

Derived from Linear issue PLTF-2910.

@jpelletier1 can click here to continue refining the PR