Does Plugin Debugger automatically modify my files?

No, it primarily focuses on investigation and simulation. It identifies the root cause and provides a 'Repair Report' with suggested actions for the user to approve or execute.

When should I use the Plugin Debugger instead of plugin-health?

Use plugin-health for a quick, global status check of all plugins. Use Plugin Debugger when a specific plugin is malfunctioning, such as when hooks aren't firing or files are locked unexpectedly.

How does this skill handle 'Operation not permitted' errors?

It specifically scans for 'uchg' (user unchangeable) flags and directory permissions that are often set by automation hooks, providing commands to unlock the paths and fix the underlying logic.

Can it fix version mismatches between my source code and Claude?

Yes, it compares the plugin.json versions and file diffs between your source directory and the ~/.claude/plugins/cache/ folder to identify synchronization gaps.

Plugin Debugger

Name: Plugin Debugger
Author: PsychQuant

byPsychQuant

0•

開発者ツール

Diagnoses and resolves complex Claude Code plugin issues including hook anomalies, cache version mismatches, and file system permission conflicts.

Plugin Debugger is a specialized diagnostic utility designed to troubleshoot individual Claude Code plugins when they exhibit unexpected behavior. It provides a multi-phase investigation framework that compares source code against active cache versions, analyzes hook execution logic for unintended side effects, and identifies file system locks like chflags or Dropbox synchronization conflicts. This skill is indispensable for developers building custom plugins who need to resolve 'stuck' hooks, 'Operation not permitted' errors, or synchronization issues between their development environment and Claude's runtime cache.

主な機能

01Stale cache detection to identify and remove legacy plugin versions

02Deep version consistency analysis between source repositories and active plugin caches

03File system diagnostic for chflags and permission-based access issues

04Automated hook logic analysis and side-effect simulation for PostToolUse events

050 GitHub stars

06Detailed diagnostic reporting with step-by-step remediation commands

ユースケース

01Fixing 'Operation not permitted' errors in archived directories caused by automated locking hooks

02Troubleshooting why source code updates aren't reflected in the plugin's active behavior

03Debugging complex hook chains that cause unexpected file modifications or tool failures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add psychquant/psychquant-claude-plugins plugin-debug

For use in Claude.ai and ChatGPT

主な機能

01Stale cache detection to identify and remove legacy plugin versions

02Deep version consistency analysis between source repositories and active plugin caches

03File system diagnostic for chflags and permission-based access issues

04Automated hook logic analysis and side-effect simulation for PostToolUse events

050 GitHub stars

06Detailed diagnostic reporting with step-by-step remediation commands

ユースケース

01Fixing 'Operation not permitted' errors in archived directories caused by automated locking hooks

02Troubleshooting why source code updates aren't reflected in the plugin's active behavior

03Debugging complex hook chains that cause unexpected file modifications or tool failures