audit-plugin

Audit hero-skills plugin skills for structure, size, DRY violations, and HERO.md field coverage.

5|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/ai-hero/hero-skills --skill audit-plugin-ai-hero
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-plugin
Source: https://github.com/ai-hero/hero-skills/tree/main/skills/audit-plugin
Command: npx skills add https://github.com/ai-hero/hero-skills --skill audit-plugin-ai-hero

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a plugin made of many skill files leads to inconsistent structure, bloated skills, duplicated instructions, and configuration fields that no skill actually reads. This Skill audits the hero-skills plugin itself so quality issues are caught before release. ## Core Features & Use Cases - Structure and Size Checks: Verifies frontmatter fields, heading hierarchy, step numbering, and flags skills that are too large or too thin. - DRY and Description Analysis: Detects instructions repeated across 3+ skills and evaluates frontmatter descriptions for trigger clarity and length. - HERO.md Field Coverage: Cross-references the declared field map against what skills actually read, reporting drift in both directions. - Use Case: Before releasing changes to the hero-skills plugin, run the audit to get a MUST FIX / SHOULD FIX / INFO report, or pass --fix to auto-correct ordering and formatting issues. ## Quick Start Ask the AI to audit the hero-skills plugin for quality and consistency issues and report what must be fixed before release.

Frequently Asked Questions about audit-plugin

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

FAQPage Schema
How do I audit a Claude Code plugin for skill quality?▼

Run the audit-plugin skill in the hero-skills repository. It reads every skills/*/SKILL.md file, checks frontmatter, structure, size, and descriptions, then reports findings grouped as MUST FIX, SHOULD FIX, and INFO.

How to check which HERO.md fields are actually used by skills?▼

The audit runs scripts/hero-fields.sh --all to get the declared field map, then cross-references it against what skills actually read. It reports fields no skill consumes and fields the map omits.

Can the plugin audit auto-fix the issues it finds?▼

Yes, pass --fix to auto-correct alphabetical ordering in tables, frontmatter field ordering, step renumbering gaps, and trailing whitespace. Content changes, description rewrites, and structural reorganization are never auto-fixed.

Does the audit treat all repeated instructions as DRY violations?▼

No. Skills run independently and cannot share runtime state, so some repetition is by design. The audit only flags the same substantive instruction appearing in 3+ skills when it could be removed via a shared reference file.

When should I not use this audit skill?▼

Do not use it on user projects; it is specific to the hero-skills plugin repository and audits the plugin's own skills. For general project checks, use the plugin's test or review skills instead.