health-check

Diagnose CLI, authentication, YAML/JSON, MCP connectivity, and symlink issues.

1|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/ReefBytes/Manifest --skill health-check-reefbytes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health-check
Source: https://github.com/ReefBytes/Manifest/tree/main/configs/claude/skills/health-check
Command: npx skills add https://github.com/ReefBytes/Manifest --skill health-check-reefbytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify and diagnose environment misconfigurations and tool availability issues that impede the Manifest agent ecosystem.

Core Features & Use Cases

  • CLI/tool availability checks: verify required CLIs are installed and report versions.
  • Authentication and config validation: ensure accounts are authenticated and YAML/JSON config files are syntactically valid.
  • Connectivity and integrity checks: validate MCP server reachability and symlink integrity across components.
  • Use Case: When onboarding a new machine, run health checks to surface missing tools and misconfigurations before deployment.

Quick Start

Run the health check from the repository root and review the generated report for actionable items.

Frequently Asked Questions about health-check

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

FAQPage Schema
How do I diagnose environment misconfigurations and tool availability issues for CLI agents?

To diagnose environment misconfigurations and tool availability issues, run a health check from your repository root to validate installed CLI versions and generate an actionable report. It surfaces missing tools and configuration errors before deployment.

How do I validate YAML and JSON configuration syntax for MCP servers?

You validate YAML and JSON configuration syntax by running an environment health check that parses the files directly. The health check verifies syntactic validity and outputs a structured report detailing any configuration errors found.

Does the health check work with macOS and Linux setups for multiple CLIs like Claude and Cursor?

Yes, the health check works with cross-platform macOS and Linux setups to verify multiple CLIs like Claude, Gemini, Cursor, and Codex. It checks authentication status, tool availability, and version reporting across these environments.

Why does my MCP server connectivity fail during environment validation?

MCP server connectivity fails during environment validation when the HTTP endpoints are unreachable. The health check tests HTTP reachability to MCP servers and reports connectivity issues in a structured diagnostic summary for troubleshooting.

What is the best way to check cross-project symlinks and CLI tool readiness before deployment?

The best way to check cross-project symlinks and CLI tool readiness is to run a comprehensive health check on a new machine. It validates symlink integrity across components and verifies required CLI installations before you deploy.