hex-doctorlisted

Validate hex agent structure and repair issues. Runs health checks against the expected directory layout, reports findings by severity, and auto-fixes safe issues. Also handles data migration from backup directories on first launch after bootstrap migration. Use when the user says "hex doctor", "check health", "fix my hex", "something is broken", or on first launch when .hex/migrate-from exists.
mrap/hex · ★ 2 · AI & Automation · score 78

Install: claude install-skill mrap/hex

# Hex Doctor Validates and repairs your hex agent installation. ## Modes ### Health Check (default) Run when the user invokes hex-doctor or when the startup health check detects issues. 1. Run `hex doctor run --fix` to auto-fix all scriptable issues 2. Parse the output for any unfixed errors (checks that doctor.sh cannot fix: .hex/, skills/, CLAUDE.md, AGENTS.md) 3. Handle LLM-fixable issues: - **AGENTS.md missing**: Generate from CLAUDE.md (requires understanding format differences between Claude and Codex) - **Complex symlink decisions**: Prompt the user if `.agents/skills/` exists as a real non-empty directory (doctor.sh warns and skips this case) 4. Present summary of all findings (from doctor.sh output + any LLM fixes applied) ### Migration (when .hex/migrate-from exists) Run automatically on first launch after bootstrap migration. 1. Read `.hex/migrate-from` to find backup directory 2. Verify backup directory exists and is readable 3. Migrate user data from backup to current agent: - `me/` (me.md, learnings.md, decisions/) - `projects/*/` - `people/*/` - `raw/` (transcripts, messages, calendar, docs, captures) - `evolution/` (observations, suggestions, changelog, metrics) - `landings/` (daily + weekly) - `todo.md` - `teams.json` - `.hex/memory.db` (then re-index) - `.hex/settings.local.json` - User-created custom skills (skills not in the template) 4. Run health check to verify migration 5. Present mig