Agent skill · operations · aiskillstore
skill-auditor
Audits and validates skill definitions for quality, completeness, and best practices. Use when reviewing existing skills for proper formatting, evaluating if skills should be split into sub-skills, or ensuring skills follow established conventions.
Why this skill is useful
Adds a structured audit process for skill validation that ensures quality and adherence to best practices, which the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Skill Auditor This skill audits other skills for quality, completeness, and adherence to best practices. It validates skill structure, evaluates content quality, and recommends improvements or decomposition into sub-skills. When to Use This skill should be triggered when: Reviewing existing skills for quality issues Checking if a skill follows proper formatting conventions Evaluating whether a skill should be divided into sub-skills Performing bulk audits across all project skills Validating skills before packaging or distribution Workflow Step 1: Discover Skills List all skills in the .claude/skills/ directory: For each skill directory, verify it contains the required SKILL.md file. Step 2: Run Automated Validation Execute the audit script to check structural requirements: The script validates: YAML frontmatter presence and required fields Description quality (length, specificity) Word count limits (<5000 words recommended) Unfinished placeholder detection Empty directory warnings Script executability Step 3: Manual Quality Review For each skill, evaluate against these criteria: Frontmatter Quality: name: Uses hyphens, is descriptive description: 50+ characters, specific about triggers, no placeholders Content Structure: Clear "When to Use" section with specific triggers Workflow with actionable steps Bundled resources properly documented Decomposition Analysis: Evaluate if skill handles >3 distinct concerns Check if skill exceeds 5000 words Identify reusable components that could be shared Step 4: Generate Audit Report Produce a structured report for each skill: Step 5: Apply Fixes For automated fixes, use the audit script with --fix flag: For manual improvements, edit SKILL.md files directly following recommendations. Audit Criteria Reference See references/audit-criteria.md for detailed scoring rubrics and decomposition guidelines. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/skill-auditor