skills.rest
whmathews15
whmathews15COMMUNITY
Explore all skills by this author →
GitHub

health-check

Diagnose Dex MCP health issues from cached pre-flight checks and error logs.

1|Updated Jun 28, 2026
Search Tags:#configuration#mcp#health check#diagnostics#preflight#self-repair#error logs
One-click install
npx skills add https://github.com/whmathews15/DEX-Personal-Operating-System --skill health-check-whmathews15
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/whmathews15/DEX-Personal-Operating-System/tree/main/.claude/skills/health-check
Command: npx skills add https://github.com/whmathews15/DEX-Personal-Operating-System --skill health-check-whmathews15

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies why Dex's MCP servers, configs, or recent tool calls are failing and turns technical failures into clear, actionable guidance.

Core Features & Use Cases

  • Health Summary: Reads cached pre-flight results and recent error logs to show which services are healthy, warning, or broken.
  • Root-Cause Diagnosis: Maps common technical failures to plain-language explanations and targeted fixes for packages, configuration, files, permissions, and connections.
  • Auto-Fix Guidance: Helps repair recoverable issues, acknowledge resolved errors, and verify the system again after fixes.
  • Use Case: A user sees a broken MCP tool at startup and asks Dex to check system status, explain the issue, and fix what can be safely repaired.

Quick Start

Ask Dex to run a health check and fix any recoverable MCP server issues.

Frequently Asked Questions about health-check

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

FAQPage Schema
How do I diagnose broken MCP server tools and startup warnings in Dex?▼

Diagnose broken MCP server tools by running a health check that reads cached pre-flight results from .logs/mcp-health.json and correlates them with recent error logs to identify failing services and summarize plain-language fixes.

Why does my MCP configuration fail when starting up Dex?▼

MCP configuration failures during startup are detected by correlating pre-flight checks and error logs, mapping technical issues like missing packages, file permission errors, or bad configuration to actionable explanations and targeted repairs.

Can I auto-repair file permission issues and missing packages for MCP servers?▼

Yes, you can auto-repair recoverable MCP server issues like missing packages and file permission problems by applying safe fixes, acknowledging resolved errors, and running a fresh re-check to verify system health.

What is the best way to verify MCP server health when health files are absent?▼

The best way to verify MCP server health without health files is to trigger a manual server verification process that runs fresh diagnostics, bypassing cached .logs/mcp-health.json data to detect current configuration and connection problems.

How does correlating pre-flight checks and error logs help fix Dex MCP issues?▼

Correlating pre-flight checks with error logs maps technical failures to plain-language explanations, showing which services are healthy, warning, or broken, and providing targeted fixes for packages, configuration, and permissions.

Does the Dex health check support acknowledging resolved errors and re-checking?▼

Yes, the Dex health check supports acknowledging resolved errors from the error queue and running fresh re-checks to confirm that auto-repair actions successfully restored MCP server and configuration health.

Related Skills

Explore More Software Engineering Skills→
okgoogle13okgoogle13
1

mcp-documentation-skill

Retrieve cached codebase documentation from the MCP server.

Community
Advanced
manastalukdarmanastalukdar
1

canary

Poll logs, error rates, and endpoints to verify post-deployment health.

Community
Advanced
math-incmath-inc
1.2k

native-mcp

Integrate a built-in MCP client into Gauss Agent to auto-discover and register external MCP server tools.

Official
Advanced
hemoryhemory

health-check

Diagnose Amp system issues by analyzing MCP server health, configuration files, and error logs.

Community
Advanced