Why would a skill receive a WARN status instead of a FAIL?

Warnings are triggered for non-critical issues, such as orchestration skills that may legitimately lack rules, or references that might be located in non-standard paths.

Can I run this audit manually or is it automated?

You can invoke it manually through Claude to get a real-time report, or run the provided bash script within the OrchestKit directory for automated reporting.

Does this skill help with SEO for my own documentation?

Indirectly, yes. By ensuring your SKILL.md files have proper titles, descriptions, and tags, it helps maintain a well-structured and searchable internal skill directory.

What specifically does the audit-skills plugin check for?

It validates the structure of SKILL.md files, including the presence of mandatory frontmatter, file length constraints, the existence of specific rules and references, and registration within the project manifest.

Skill Audit & Compliance

Name: Skill Audit & Compliance
Author: yonatangross

byyonatangross

•

128

•

Security & Testing

Audits and validates Claude Code skills to ensure they meet quality standards, complete metadata, and optimal performance patterns.

The audit-skills tool provides an automated quality assurance layer for OrchestKit, scanning SKILL.md files for compliance with rigorous authoring standards. It systematically identifies missing frontmatter, oversized files, unregistered manifests, and absent rules or references, ensuring every skill in your repository remains production-ready and consistent. By streamlining the validation process before releases or after bulk edits, it provides developers with a clear, actionable dashboard of skill health, featuring standardized PASS/WARN/FAIL status reporting.

Key Features

01Validation of frontmatter fields, required rules, and external documentation references

02Standardized reporting with status classifications (PASS/WARN/FAIL) and impact levels

03Parallel execution of audit checks for high-performance scanning of large skill sets

04128 GitHub stars

05Automated scanning of SKILL.md files for structural integrity and metadata compliance

06Manifest verification to ensure all skills are correctly registered within the toolkit

Use Cases

01Standardizing documentation and metadata across a large library of AI development skills

02Performing a final quality gate check before releasing new skills to a production repository

03Identifying broken references or missing configuration after performing bulk edits to skill files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit audit-skills

For use in Claude.ai and ChatGPT

Download Skill