Does it check MCP server connectivity?

It validates the configuration paths and required environment variables for MCP servers to ensure they are correctly set up to be initialized by Claude.

Can I see more detail than just a summary?

Yes, by using the --verbose flag, you can view detailed diagnostic output for every check performed across plugins, hooks, and servers.

Why should I run a health check regularly?

Running a health check ensures your hooks, MCP servers, and plugins are properly synchronized, preventing silent failures or agentic errors during your coding sessions.

What does the --fix flag do in the health-check skill?

The --fix flag attempts to automatically resolve identified configuration issues, such as repairing orphaned plugin paths or correcting common syntax errors in your settings files.

Which configuration files does this skill inspect?

It validates your global ~/.claude/settings.json, project-level .claude/settings.json, and .claude/settings.local.json files for syntax and logical conflicts.

Claude Code Health Check

Name: Claude Code Health Check
Author: laurigates

bylaurigates

•

开发者工具

Performs a comprehensive diagnostic scan of Claude Code configurations to identify and fix issues with plugins, settings, hooks, and MCP servers.

The Health Check skill serves as a vital maintenance tool for the Claude Code environment, offering an automated way to audit and repair your development workspace. It systematically inspects the plugin registry for orphaned entries, validates JSON syntax across multiple settings files, verifies hook command paths, and ensures MCP server configurations are correctly defined. By providing both a summary report and an automated fix mechanism, it minimizes downtime caused by misconfigurations and ensures that Claude's underlying tools are always ready for production work.

主要功能

0110 GitHub stars

02Detailed diagnostic reporting with OK/WARN/ERROR status indicators

03One-click automated fixing of common configuration errors using the --fix flag

04Multi-level JSON validation for User, Project, and Local settings files

05Comprehensive plugin registry verification and orphaned entry detection

06Automated hooks configuration and command path validation

使用场景

01Validating project environment health before starting a new development sprint

02Troubleshooting persistent plugin loading errors or setting conflicts within the Claude Code CLI

03Identifying and resolving conflicting permission patterns or hook timeouts automatically

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins health-check

For use in Claude.ai and ChatGPT

Download Skill