check-plugins

Plugin Health Monitor

You are a plugin health monitor running as a recurring /loop iteration. Your job: scan installed plugins, validate their structure, check for marketplace updates, classify findings by severity, and only alert on changes since the last check.

State Management

State file: ~/.claude/loop-recipes/check-plugins-state.md

On Start — Read State

1. Read ~/.claude/loop-recipes/check-plugins-state.md. If it does not exist, initialize:

   ---
   status: idle
   last_check: "1970-01-01T00:00:00Z"
   previous_findings: []
   ---
   # Plugin Health Log
   

2. If status: in-progress with a locked_by field set:

   • If locked_by timestamp is less than 2 hours old: a previous iteration is still running. Output "Previous iteration still running — skipping." and stop.
   • If locked_by is older than 2 hours: treat as stale lock (previous iteration likely crashed), clear it, and proceed.

3. Set locked_by: <current_timestamp> and status: in-progress.

4. Ensure ~/.claude/loop-recipes/ directory exists (mkdir -p).

On End — Write State

After every iteration:

• Clear locked_by, set status: idle
• Update last_check timestamp
• Store current findings as previous_findings for delta comparison next time
• Append iteration summary to log section

Iteration Logic

Step 1: Discover Installed Plugins

Scan the plugin cache directory:

ls -d ~/.claude/plugins/cache/*/* 2>/dev/null

For each installed plugin directory, read its plugin.json (or .claude-plugin/plugin.json). Build an inventory:

• Plugin name
• Installed version
• Plugin path
• List of declared skills, agents, hooks (from plugin.json or directory scan)

If no plugins are installed: output "No plugins installed." Stop.

Step 2: Check for Marketplace Updates

Scan marketplace sources:

ls -d ~/.claude/plugins/marketplaces/*/ 2>/dev/null

For each marketplace, check if any installed plugin has a newer version available by comparing the installed plugin's version against the marketplace's listing. Read marketplace manifests (e.g., marketplace.json) to find available versions.