audit-content-quality

Scores SKILL.md files against a 6-criteria quality rubric with per-skill grades.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill audit-content-quality-javimontano
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-content-quality
Source: https://github.com/JaviMontano/mao-plugin-qa/tree/main/skills/audit-content-quality
Command: npx skills add https://github.com/JaviMontano/mao-plugin-qa --skill audit-content-quality-javimontano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Plugin authors lack an objective way to measure whether their SKILL.md files meet quality standards, making it hard to find weak skills and systematic documentation gaps across a plugin. ## Core Features & Use Cases - 6-Dimension Scoring: Evaluates Completeness, Description Quality, Procedure Clarity, Quality Criteria, Anti-Patterns, and Edge Cases on a 1-10 scale per skill. - Plugin-Level Analysis: Computes plugin averages, letter grades (A-F), identifies the bottom 3 weakest skills, and flags systematic gaps where any criterion averages below 6.0. - Actionable Reports: Produces a machine-parseable scorecard table with per-criterion rationales and specific improvement suggestions. - Use Case: Before publishing a Claude Code plugin, run this audit to discover that three skills lack edge cases and one has malformed frontmatter, then fix them with targeted guidance. ## Quick Start Audit the content quality of all skills in my plugin and show me the scorecard with the weakest skills.

Frequently Asked Questions about audit-content-quality

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

FAQPage Schema
How do I audit the quality of SKILL.md files in a Claude Code plugin?▼

Run the audit on the plugin root; it globs all SKILL.md files, parses frontmatter and body sections, and scores each on 6 dimensions totaling 60 points. The output is a scorecard table with grades from A to F.

What criteria are used to score skill content quality?▼

Six dimensions are scored 1-10 each: Completeness, Description Quality, Procedure Clarity, Quality Criteria, Anti-Patterns, and Edge Cases. Scores sum to 60 and map to letter grades, with A starting at 90 percent.

Does the audit modify my SKILL.md files?▼

No, the audit is strictly read-only. It only reads and parses skill files to produce scores and recommendations, never writing changes back to the plugin.

What happens if a SKILL.md has malformed or missing frontmatter?▼

The file is not skipped. It scores 1 on Completeness and Description Quality with an explicit note, and the audit still attempts to parse and score the remaining body sections.

What are the limitations of automated skill quality scoring?▼

Scoring is structural, not semantic, so a well-formatted but factually wrong procedure can still score high. Systematic gap detection also requires at least 3 skills to be statistically meaningful.