mp-skill-audit

Audit Claude Code SKILL.md files for metadata gaps and convention drift.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-skill-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-skill-audit
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-skill-audit
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-skill-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you maintain consistent, trustworthy Claude Code skill files by detecting convention drift and common documentation/behavior mismatches before they cause user friction.

Core Features & Use Cases

  • Scans active skills for mechanical and convention issues across every skills/*/SKILL.md (excluding skills/deprecated/) and checks both metadata correctness and instruction quality.
  • Runs targeted audits for eight high-signal checks, including negative-instruction phrasing, frontmatter completeness, trigger phrase presence, legacy doc references, and description-to-body alignment.
  • Auto-fixes common, low-risk problems like rephrasing negative guards, correcting category casing, replacing legacy documentation references, and filling missing frontmatter fields with sensible defaults.

Quick Start

Use the audit command to scan all active skills and automatically fix mechanical issues where possible: mp-skill-audit

Frequently Asked Questions about mp-skill-audit

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

FAQPage Schema
How do I check Claude Code skills for markdown frontmatter and convention drift?

To check Claude Code skills for markdown frontmatter and convention drift, run an audit that scans all `SKILL.md` files to validate required fields, allowed tools, and trigger phrases, then safely auto-fixes common mechanical issues.

How do I auto-fix negative instructions and missing frontmatter in SKILL.md files?

You can auto-fix negative instructions and missing frontmatter in `SKILL.md` files by running a skill audit that rephrases negative guards and fills missing metadata fields with sensible defaults.

What causes description-to-body mismatches in Claude Code skills?

Description-to-body mismatches in Claude Code skills occur when the declared metadata does not align with the actual instructions. An audit detects these inconsistencies along with legacy documentation references to maintain reliable behavior.

Does the skill audit exclude deprecated folders when scanning repository-wide skill hygiene?

Yes, the skill audit excludes the `skills/deprecated/` folder when scanning repository-wide skill hygiene, ensuring it only evaluates active `skills/*/SKILL.md` files for convention errors and instruction quality.

How do I validate allowed categories and trigger phrases across multiple SKILL.md files?

To validate allowed categories and trigger phrases across multiple `SKILL.md` files, run a targeted audit that enforces frontmatter completeness and checks for the presence of required trigger phrases to prevent authoring errors.

When should I run a targeted skill audit instead of a repository-wide scan?

You should run a targeted skill audit instead of a repository-wide scan when debugging a single skill or checking for common authoring errors, allowing you to focus on specific instruction and behavior mismatches without evaluating the entire repository.