midnight-expert:doctor

Assesses plugin, MCP server, CLI, and NPM registry health for the midnight-expert environment.

37|9|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-expert-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: midnight-expert:doctor
Source: https://github.com/devrelaicom/midnight-expert/tree/main/plugins/midnight-expert/skills/doctor
Command: npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-expert-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, curl, npm, npx, node, git, gh, docker, jq, tsc, nvm, claude, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a single, consistent diagnostic workflow to detect, report, and optionally remediate problems across the midnight-expert ecosystem so developers can quickly restore a working development environment.

Core Features & Use Cases

  • Concurrent diagnostics: Launches five background agents to check plugin health, MCP servers, external CLI tools, cross-plugin references, and NPM registry reachability.
  • Structured reporting: Parses CHECK_NAME | STATUS | DETAIL output into a unified health report that maps statuses to PASS/WARN/FAIL badges and omits all-clear sections for brevity.
  • Guided remediation: Offers an optional --auto-fix mode and interactive fix prompts driven by platform-aware recipes in references/fix-table.md, re-verifying only affected checks after fixes.

Quick Start

Ask the assistant to run /midnight-expert:doctor and present a guided health report with suggested fixes.

Frequently Asked Questions about midnight-expert:doctor

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

FAQPage Schema
How do I run diagnostics to check my NPM and CLI tooling environment?▼

Run diagnostics by launching concurrent background scripts that check plugin health, MCP servers, external CLI tools, cross-plugin references, and NPM registry reachability. The system parses CHECK_NAME | STATUS | DETAIL output into a unified health report with PASS/WARN/FAIL badges.

Can I automatically repair MCP servers and plugin installations?▼

Yes, you can automatically repair MCP servers and plugin installations using the optional --auto-fix mode. It uses interactive fix prompts driven by platform-aware recipes and re-verifies only affected checks after applying remediation.

What CLI dependencies do I need to run a full developer environment health check?▼

A full health check requires python3, curl, npm, npx, node, git, gh, docker, jq, tsc, nvm, and claude installed. These external CLI tools are assessed alongside cross-plugin references and NPM registry reachability during diagnostics.

Why does my CI environment fail NPM registry reachability checks?▼

NPM registry reachability checks fail when network policies or proxy configurations block access. The diagnostic script tests registry connections and reports the failure status, allowing the platform-aware fix-table to suggest appropriate remediation steps.

Does the diagnostic tool work for both local developer machines and CI environments?▼

Yes, the diagnostic tool works for both local developer machines and CI environments. It assesses plugin installations, MCP servers, and external CLI tooling, providing platform-aware remediation recipes that adapt to the specific operating environment.

What is the best way to troubleshoot broken cross-plugin references in my dev environment?▼

The best way to troubleshoot broken cross-plugin references is running concurrent diagnostic scripts that assess plugin health and dependencies. The structured health report identifies WARN or FAIL statuses, offering guided remediation through platform-aware fix-table recipes.