maxxing-doctor — Claude Code skill: diagnostic and repair
The maxxing-doctor skill for Claude Code detects and resolves issues with Harness Maxxing installations. It activates when the UI fails to load, sessions hang, or automated tasks stop running.
no license ★ 285 updated 2026-11-17
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a claude-codeWhat maxxing-doctor does
This skill generates diagnostic reports via maxxing doctor, verifies service status, and examines logs using systemctl or journalctl. The agent analyzes the environment and configuration to identify the root cause without performing intrusive operations like data deletion.
It requires system-level access to service logs and application directories. The tool avoids destructive git actions unless explicitly allowed. When dependency errors occur, it triggers uv sync --frozen --no-dev to restore the environment state.
What it helps with
- Resolve stuck sessions and background jobs
- Debug UI connection errors via service logs
- Sync dependencies after manual code updates
- Correct timezone discrepancies for scheduled tasks
Example prompts for the agent
- maxxing-doctor: why is the UI not loading?
- maxxing-doctor: check status and recent logs
How to install maxxing-doctor
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a claude-code2Manually: put the files in place
~/.claude/skills/maxxing-doctor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/maxxing-doctor/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a codex2Manually: put the files in place
.agents/skills/maxxing-doctor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a cursor2Manually: put the files in place
.cursor/skills/maxxing-doctor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makushingu/harness-maxxing skills/maxxing-doctor2Manually: put the files in place
.github/skills/maxxing-doctor/SKILL.md1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a gemini-cli2Platform CLI
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-doctorManually: put the files in place
.devin/skills/maxxing-doctor/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about maxxing-doctor
How to install maxxing-doctor in Claude Code?
Run npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a claude-code to install the skill.
What does maxxing-doctor do?
It diagnoses Harness Maxxing installations, identifying causes for session hangs, scheduled task failures, or connectivity issues.
What is required to run it?
System-level access to service logs and the ability to execute maxxing commands within the environment.