skills.rest
PsychQuant
PsychQuantOFFICIAL
Explore all skills by this author →
WebsiteGitHub

plugin-health

Diagnose and resolve common issues with installed Claude Code plugins.

Updated Jan 10, 2026
Search Tags:#debugging#troubleshooting#claude code#plugin#health check#diagnostics
One-click install
npx skills add https://github.com/PsychQuant/psychquant-claude-plugins --skill plugin-health
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
BrennonTWilliamsBrennonTWilliams
7

update

Update the little-loops CLI package and Claude Code plugin to latest versions.

Community
Intermediate
ojowwalker77ojowwalker77
110

Matrix Doctor

Diagnose and repair Matrix plugin health issues, returning a structured DoctorResult object.

Community
Advanced
timequitytimequity
6

intermediate

Create custom skills, commands, servers, and hooks for automating workflows in Claude Code.

Official
Intermediate
MacPhobosMacPhobos

mpm-doctor

Diagnose Claude MPM installations by verifying components and reporting statuses.

Community
Basic