Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add makushingu/harness-maxxing --skill maxxing-doctor -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/maxxing-doctor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/maxxing-doctor/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set21

The whole set →
maxxing-backup The maxxing-backup skill for Claude Code saves the agent's memory workspace to a private GitHub repository. It runs on a daily schedule or upon specific user commands. CX Codex +1 ★ 285repo stars maxxing-setup maxxing-setup is a Claude Code skill that guides Harness Maxxing setup from the server terminal. It kicks in after installation or when changing access, signing in to Claude, or configuring Telegram and backups. CX Codex +1 ★ 285repo stars video-motion-design video-motion-design is a Claude Code skill that generates motion design videos using Remotion and React. It creates animated intros, trailers, and explainers upon user request. CX Codex +1 ★ 285repo stars maxxing-mail maxxing-mail is a Claude Code skill that handles mailbox tasks through maxxing mail. It activates for requests to find, sort, read, or reply to email, or to give an agent mailbox access. CX Codex +1 ★ 285repo stars maxxing-feed maxxing-feed is a Claude Code skill that routes events to the Harness Maxxing notification feed. It activates for requests to watch orders, email, deployments, or script results. CX Codex +1 ★ 285repo stars maxxing-cron The maxxing-cron skill for Claude Code automates shell commands or AI prompts on a schedule with Telegram reporting. It handles recurring tasks and future reminders. CX Codex +1 ★ 285repo stars maxxing-browser maxxing-browser is a Claude Code skill for configuring and troubleshooting Harness Browser. It activates for site sign-ins, form entry, page navigation, or browser access failures. CX Codex +1 ★ 285repo stars maxxing-telegram maxxing-telegram is a Claude Code skill that configures the Harness Maxxing Telegram gateway. It handles bot linking, session modes, mobile inputs, and server alerts. CX Codex +1 ★ 285repo stars

Project sponsors

Companies that keep this analytics open