plugin-health

Name: plugin-health
Availability: InStock
Author: PsychQuant

Diagnose and resolve common issues with installed Claude Code plugins.

Updated Jan 10, 2026

Search Tags:#debugging #troubleshooting #claude code #plugin #health check #diagnostics

Ready to run

npx skills add https://github.com/PsychQuant/psychquant-claude-plugins --skill plugin-health

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plugin-health
Source: https://github.com/PsychQuant/psychquant-claude-plugins/tree/main/plugins/plugin-tools/skills/plugin-health
Command: npx skills add https://github.com/PsychQuant/psychquant-claude-plugins --skill plugin-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, jq, ls, file, chmod, grep, claude, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users troubleshoot and resolve common problems that prevent plugins from loading or functioning correctly, ensuring a smooth experience with Claude Code plugins.

Core Features & Use Cases

Comprehensive Health Checks: Identifies issues like incorrect hook formats, missing scripts, permission errors, and missing binaries.
Diagnostic Reporting: Provides a clear report of detected problems and suggested fixes.
Use Case: If a user reports that a newly installed plugin "isn't working" or "failed to load," this Skill can automatically diagnose the underlying cause and guide the user through the necessary corrections.

Quick Start

Run a health check on all installed plugins to identify any issues.

Frequently Asked Questions about plugin-health

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

FAQPage Schema

Why does my Claude Code plugin fail to load or function correctly?▼

Plugin loading errors often stem from incorrect hook formats, missing scripts, or invalid plugin.json files. A diagnostic health check scans your plugin configurations and file system integrity to identify the specific underlying cause and provide actionable repair steps.

How do I diagnose script permission problems and missing MCP binaries in Claude Code?▼

You diagnose script permission problems and missing MCP binaries by running a comprehensive health check. This process verifies script executability using file permissions and confirms MCP binary presence, then reports detected issues with suggested fixes.

Does this plugin diagnostics tool require specific dependencies like python3 or jq to run?▼

Yes, this plugin diagnostics tool requires python3, jq, ls, file, chmod, grep, and the claude command. These dependencies are utilized to scan plugin configurations, verify hook schemas, check script executability, and validate plugin.json integrity.

What is the best way to fix version mismatches and incorrect hook formats in installed plugins?▼

The best way to fix version mismatches and incorrect hook formats is to perform a diagnostic scan of your installed plugins. This health check validates hook schemas and configuration files, outputting a clear report of detected problems alongside actionable repair steps.

Can I run a health check on all installed Claude Code plugins at once?▼

Yes, you can run a comprehensive health check on all installed Claude Code plugins simultaneously. The diagnostic scan automatically evaluates plugin.json validity, hook schemas, script executability, and MCP binary presence across your entire plugin configuration.