health-check

Diagnose Dex MCP server health issues from cached pre-flight results and error queues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mengblom/dex-ghx --skill health-check-mengblom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/mengblom/dex-ghx/tree/main/.claude/skills/health-check
Command: npx skills add https://github.com/mengblom/dex-ghx --skill health-check-mengblom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Health-check helps diagnose why Dex MCP tools or servers are failing, then recommends practical fixes so your system returns to working order.

Core Features & Use Cases

  • MCP server health diagnosis: Reads cached pre-flight results and a recent error queue to identify failing or unstable MCP servers.
  • Plain-language reporting: Summarizes issues as actionable, user-friendly errors and warnings without exposing raw JSON or stack traces.
  • Targeted repair workflows: Suggests fixes for common categories like missing Python packages, broken/missing MCP config, corrupted JSON, missing vault files, and permission problems; can also attempt auto-fixes when safe.

Use case example: After updating Dex or starting a new session, some tools (like Work MCP task sync) fail—run health-check to pinpoint which MCP server is broken and what to do next.

Quick Start

Ask your AI to run the command /health-check to get a Dex Health Report and recommended fixes.

Frequently Asked Questions about health-check

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

FAQPage Schema
How do I diagnose and fix failing MCP server tool calls?▼

To diagnose failing MCP server tool calls, analyze cached pre-flight results and recent error queues to identify broken servers and map failures to actionable remediation steps. This process reads specific log files to recommend targeted fixes.

What is the best way to troubleshoot missing or corrupted MCP configuration files?▼

The best way to troubleshoot corrupted MCP configuration files is to run a health diagnostic that reads the error queue and maps JSON corruption or missing vault files to targeted repair workflows. It can optionally attempt safe configuration auto-fixes.

Why does my Dex system show warnings after starting a new session?▼

Dex system-start warnings occur when MCP servers fail pre-flight checks due to missing Python packages, broken config, or permission problems. A health diagnostic reads cached results to pinpoint the failing server and suggest targeted fixes.

Can I automatically repair broken MCP servers without reading raw JSON logs?▼

Yes, you can automatically repair broken MCP servers by running a diagnostic that translates raw JSON logs and error queues into plain-language summaries. It identifies safe issues and optionally applies auto-fixes without exposing technical stack traces.

Does health diagnostics work for resolving MCP permission problems and missing Python packages?▼

Yes, health diagnostics work for resolving MCP permission problems and missing Python packages by categorizing common failures from the error queue. It suggests targeted repair workflows and can run a fresh pre-flight re-check to verify the resolution.

What are the limitations of using automated error triage for MCP server issues?▼

The limitation of automated error triage for MCP server issues is that it relies on reading cached pre-flight results and error queues, meaning it cannot diagnose real-time failures outside the log files. Auto-fixes are also restricted to safe, predefined configuration issues.