This skill should be used when the user asks about 'debug plugin behavior', 'what does the debug plugin save', 'debug plugin files', 'where does debug plugin write', or mentions debug plugin data storage and session artifacts.
From debugnpx claudepluginhub masseater/claude-code-plugin --plugin debugThis skill uses the workspace's default tool permissions.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Details PluginEval's skill quality evaluation: 3 layers (static, LLM judge), 10 dimensions, rubrics, formulas, anti-patterns, badges. Use to interpret scores, improve triggering, calibrate thresholds.
Reference for the debug plugin's runtime behavior. Describes what data is saved, where it is stored, and how the SessionStart hooks operate.
The debug plugin is a lightweight diagnostic tool for Claude Code plugin development. It verifies that:
CLAUDE_PLUGIN_ROOT environment variable resolves properlyThe debug plugin's SessionStart hooks execute on every session event (startup, resume, clear, compact). The following data is produced:
| Destination | Content | Persistence |
|---|---|---|
$XDG_STATE_HOME/claude-code-plugin/debug.txt | CLAUDE_PLUGIN_ROOT absolute path | Overwritten each session |
| stdout (additionalContext) | Structured context about debug plugin status | Conversation only |
Default XDG_STATE_HOME is ~/.local/state when the environment variable is not set.
Written by the SessionStart hook at $XDG_STATE_HOME/claude-code-plugin/debug.txt. Contains the resolved CLAUDE_PLUGIN_ROOT path as a single line. Overwritten on every session start — only the most recent value is retained.
Use this file to verify that CLAUDE_PLUGIN_ROOT resolves correctly outside of the Claude Code session (e.g., from a separate terminal).
The SessionStart hook outputs a structured context message via additionalContext, which Claude Code injects as a <system-reminder>. This informs the AI that the debug plugin is active and provides key environment details. No command output is shown — only the context message is passed.
| Variable | Description |
|---|---|
CLAUDE_PLUGIN_ROOT | Absolute path to the debug plugin directory. Set by Claude Code for all plugin hooks. |
XDG_STATE_HOME | Base directory for state data. Falls back to ~/.local/state. |
When troubleshooting plugin issues:
$XDG_STATE_HOME/claude-code-plugin/debug.txt to verify CLAUDE_PLUGIN_ROOT resolutionhooks/hooks.json