audit-skills

Auditing local Claude skills requires scanning the ~/.claude/skills directory to validate each skill against manifest guidelines and upstream guidance. This process identifies frontmatter, content, tool, and UX misconfigurations, producing per-skill health reports and a summarized dashboard for quick remediation.

A Claude skills health report flags deviations from manifest guidelines and best practices. It surfaces critical issues, suggested fixes, and compliance gaps regarding frontmatter, content, tools, UX, and upstream guidance, helping maintainers keep the SKILLS_GUIDE.md inventory accurate and aligned with standards.

Validating skill frontmatter and content involves applying automated checks against local manifest guidelines. This surfaces misconfigurations and potential risks in each skill's structure and documentation, generating health reports that highlight specific deviations and suggest fixes to maintain quality and consistency.

You can scan all skills in the local ~/.claude/skills directory at once. The audit applies checks across the entire collection, generating a summarized dashboard that highlights critical issues alongside individual per-skill reports for quick remediation of any misconfigurations.

Claude skills deviate from upstream guidance when evolving best practices outpace manual updates. Auditing identifies these compliance gaps by comparing each skill's frontmatter, content, tools, and UX against current manifest guidelines, flagging misconfigurations and potential risks for targeted remediation.

The best way to maintain a large collection of Claude skills is running periodic audits against the local manifest and upstream guidance. This surfaces deviations, generates health reports, and ensures the SKILLS_GUIDE.md inventory remains accurate and aligned with evolving best practices for consistent quality.