plugin-doctor

Validate plugin frontmatter, hook scripts, and evaluation rubrics for configuration drift.

2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill plugin-doctor-alex-voloshin-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-doctor
Source: https://github.com/alex-voloshin-dev/ai-skills/tree/main/plugin/skills/plugin-doctor
Command: npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill plugin-doctor-alex-voloshin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires anthropic, and includes scripts (resource) components.

What problem does it solve?

This skill resolves configuration drift and installation issues by providing a centralized diagnostic tool to validate plugin integrity, hook executability, and judge calibration.

Core Features & Use Cases

  • Integrity Validation: Automatically checks skill frontmatter, hook script syntax, and JSON schema validity to ensure the plugin environment is correctly configured.
  • Judge Calibration: Performs score-band tolerance checks against known samples to ensure AI evaluation rubrics remain accurate and drift-free.
  • Error Triage: Provides a dashboard view of recent hook errors and warnings to quickly identify and resolve noisy or failing automation components.

Quick Start

Run the plugin doctor command to perform a full system diagnostic and verify that all hooks and rubrics are operating within healthy bounds.

Frequently Asked Questions about plugin-doctor

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

FAQPage Schema
How do I validate ai-skills plugin configuration and fix installation drift?

To validate ai-skills plugin configuration, run a diagnostic routine that lints skill frontmatter, checks hook script syntax, and verifies JSON schema validity to detect and resolve configuration drift.

What is AI judge calibration and how do I check my evaluation rubrics?

AI judge calibration is the process of checking evaluation rubrics for accuracy by performing score-band tolerance checks against known samples to ensure your AI evaluation criteria remain drift-free.

Do I need access to the plugin root directory to run a skill health-check?

Yes, you need access to the plugin root directory and the ai-skills memory store to perform comprehensive linting and calibration analysis across your skill environment.

Why does my skill frontmatter validation fail when running diagnostic routines?

Skill frontmatter validation fails when the diagnostic suite detects structural integrity issues or configuration drift in your JSON schema, preventing the plugin environment from operating within healthy bounds.