doctor

Diagnose oh-my-droid installation issues across plugins, hooks, caches, and configuration.

28|5|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/MeroZemory/oh-my-droid --skill doctor-merozemory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/MeroZemory/oh-my-droid/tree/main/skills/doctor
Command: npx skills add https://github.com/MeroZemory/oh-my-droid --skill doctor-merozemory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The doctor skill hunts down and resolves oh-my-droid installation issues by checking plugin versions, legacy hooks, caches, and supporting files so Factory Droid runs with known-good resources.

Core Features & Use Cases

  • Plugin and Cache Diagnostics: Compare installed oh-my-droid plugin versions to npm, detect stale caches, and flag missing or outdated FACTORY.md content.
  • Legacy Hook Cleanup: Inspect settings.json hooks, ~/.factory/hooks scripts, and legacy curl-installed agents, commands, and skills to prevent duplication and conflicts.
  • Automated Fix Recommendations: Summarize findings in a structured report, invite user confirmation, and outline fixes such as removing legacy scripts, refreshing FACTORY.md, or pruning cache to stay on the latest release.
  • Use Case: Run after a Factory Droid upgrade to ensure no leftover legacy hooks or cached versions obstruct the new autopilot workflow.

Quick Start

Ask the doctor skill to diagnose your oh-my-droid installation health.

Frequently Asked Questions about doctor

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

FAQPage Schema
How do I diagnose oh-my-droid installation issues and legacy hook conflicts?

To diagnose oh-my-droid installation issues, scan settings.json hooks, ~/.factory/hooks scripts, and caches to detect deprecated bash scripts and stale resources. The diagnostic process compares installed plugin versions against npm, verifies FACTORY.md markers, and flags extraneous curl-installed agents.

Why does Factory Droid fail to start after an upgrade?

Factory Droid fails to start after an upgrade when leftover legacy hooks or cached plugin versions obstruct the new workflow. Scanning settings.json for deprecated bash scripts and pruning stale caches resolves these startup failures by ensuring only known-good resources are loaded.

What's the best way to fix stale oh-my-droid plugin caches and outdated FACTORY.md content?

The best way to fix stale oh-my-droid plugin caches is to run a diagnostic audit that compares installed versions to npm, counts cached resources, and verifies FACTORY.md markers. This generates a structured report outlining fixes like pruning caches and refreshing configuration files.

Can I use automated diagnostics to remove legacy curl-installed Factory Droid agents?

Yes, you can use automated diagnostics to remove legacy curl-installed Factory Droid agents. The diagnostic scan identifies extraneous cached and curl-installed agents, commands, and skills, then invites user confirmation before outlining fixes to prevent duplication and conflicts.

When do I need to check oh-my-droid plugin health and settings.json hooks?

You need to check oh-my-droid plugin health and settings.json hooks when Factory Droid installations behave unexpectedly or fail to start. Running diagnostics after upgrades ensures no deprecated bash scripts or outdated plugins conflict with the latest release.

Does the doctor skill detect missing FACTORY.md markers and outdated oh-my-droid plugins?

Yes, the doctor skill detects missing FACTORY.md markers and outdated oh-my-droid plugins by verifying installed versus latest npm versions. It audits supporting configuration files, identifies missing or outdated FACTORY.md content, and recommends refreshing the markers to maintain functional requirements.