skills.rest
benjaminshoemaker
benjaminshoemakerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

audit-skills

Audit SKILL.md files against CRITERIA.md and SCORING.md criteria.

39|5|Updated Dec 28, 2025
Search Tags:#checklist#audit#skills#quality#best-practices#code-review
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill audit-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-skills
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/audit-skills
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill audit-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes repository skills against established criteria to identify length, structure, progressive disclosure, and verification gaps, producing prioritized improvement suggestions.

Core Features & Use Cases

  • Discover and evaluate all SKILL.md files against CRITERIA.md and SCORING.md.
  • Generate a prioritized improvement report with evidence and concrete fixes.
  • Use during skill creation and reviews to elevate overall quality.

Quick Start

Use the audit-skills to scan repository skills and generate a formal audit report.

Frequently Asked Questions about audit-skills

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

FAQPage Schema
How do I audit repository skills for best-practice violations?▼

To audit repository skills, scan all SKILL.md files in the .claude/skills directory against criteria to identify length, structure, progressive disclosure, and verification gaps, producing a prioritized improvement report with concrete fixes.

What is a skill quality audit and what does the report include?▼

A skill quality audit evaluates SKILL.md files against CRITERIA.md and SCORING.md to find best-practice violations. The generated report includes prioritized improvement suggestions backed by evidence and concrete fixes.

How do I review SKILL.md files without modifying source code?▼

You can review SKILL.md files without modifying source code by running an audit that assesses structure and verification steps, outputting a formal report with evidence and concrete fixes while leaving source files completely untouched.

When should I use a skill audit during the development lifecycle?▼

Use a skill audit during skill creation and code reviews to elevate overall quality. It helps discover and evaluate all SKILL.md files early, ensuring they meet established criteria before deployment.

Does the skill audit check for progressive disclosure and verification steps?▼

Yes, the skill audit explicitly checks for progressive disclosure and verification steps. It assesses SKILL.md files across four dimensions: length, structure, progressive disclosure, and verification gaps.

What is the best way to generate concrete fixes for SKILL.md quality issues?▼

The best way to generate concrete fixes for SKILL.md quality issues is to run an audit that applies CRITERIA.md and SCORING.md rules, outputting a prioritized report with evidence and specific corrective actions.

Related Skills

Explore More Software Engineering Skills→
Ikram-AlamIkram-Alam

evaluation

Evaluate agent outputs against rubrics and ground truth with multi-dimensional scoring.

Community
Basic
sandalsoftsandalsoft

skill-auditor

Audit skills portfolios and generate actionable improvement plans with structured reports.

Community
Advanced
forranyforrany

verification-loop

Automate build, type check, lint, tests, security scan, and diff review for code changes.

Community
Intermediate
y-miyazakiy-miyazaki
1

shell-script-validation

Run a centralized validate.sh workflow with bash, shellcheck, shfmt, bats, and jq.

Community
Advanced