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.