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.