skills.rest
crisandrews
crisandrewsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

doctor

Diagnose agent workspace health across config, memory, crons, and messaging plugins.

62|14|Updated Apr 9, 2026
Search Tags:#troubleshooting#claude code#agent#sqlite#health check#diagnostics#cron
One-click install
npx skills add https://github.com/crisandrews/ClawCode --skill doctor-crisandrews
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/crisandrews/ClawCode/tree/main/skills/doctor
Command: npx skills add https://github.com/crisandrews/ClawCode --skill doctor-crisandrews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a persistent Claude Code agent misbehaves — memory search returns nothing, heartbeats stop firing, or the browser bridge won't connect — there is no built-in way to find the root cause. This Skill runs structured diagnostic checks across the entire agent workspace and optionally applies safe auto-repairs. ## Core Features & Use Cases - Comprehensive health checks: Inspects config, identity, memory, SQLite index, QMD, crons, hooks, HTTP bridge, messaging plugins, and dreaming via the agent_doctor MCP tool. - Safe auto-repair mode: With --fix, creates missing memory directories, syncs the index, and deletes stale BOOTSTRAP.md files before re-running checks. - Cron audit integration: Refreshes the cron registry audit from live CronList output so heartbeat and dreaming schedules are reported accurately. - Use Case: After running /agent:create, invoke the doctor to verify the setup is clean, or run it with --fix when memory search suddenly returns empty results. ## Quick Start Ask the agent to run a health check on the workspace, or say "run doctor with --fix" to also apply safe automatic repairs.

Frequently Asked Questions about doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a health check on my Claude Code agent?▼

Invoke /agent:doctor or ask for a diagnostic check. The skill calls the agent_doctor MCP tool in check mode and returns a formatted card covering config, identity, memory, SQLite, crons, hooks, HTTP bridge, and messaging plugins.

How do I auto-fix agent workspace problems?▼

Pass --fix or say "arreglar" to run the doctor in fix mode. It applies safe repairs such as creating the memory directory, syncing the SQLite index, and deleting stale BOOTSTRAP.md, then re-runs all checks.

Why does agent memory search return nothing?▼

Empty memory search usually indicates a corrupted or out-of-sync SQLite index. Run the doctor to check SQLite integrity, and use --fix mode to sync the index automatically.

Why are my agent heartbeat crons not firing?▼

The doctor refreshes the cron registry audit from live CronList output and reports heartbeat and dreaming schedules. Missing crons are flagged with a suggestion to run the default crons flow, and orphaned registry reminders are surfaced separately.

What does the doctor skill not check?▼

The doctor only covers checks implemented in lib/doctor.ts, such as config, memory, crons, and messaging. It does not validate external items like third-party API keys; consult docs/doctor.md for the current check list.

Related Skills

Explore More Software Engineering Skills→
awebaiawebai
82

retire-instance

Retire an aweb agent instance's identity, workspace, worktree, and branch after its job completes.

Official
Advanced
almazomalmazom

cron-skill

Manage Codex cron pilot job lifecycles via codex-cron and MCP.

Community
Advanced
project-axproject-ax
5

provider-scheduler

Schedule and execute timed messages for AI agents via cron jobs.

Official
Advanced
rnagrodzkirnagrodzki

promptfoo-results

Query Promptfoo behavioral test results from a local SQLite database.

Community
Intermediate