checking-skill-quality

To audit a SKILL.md file, validate its frontmatter, numbered Steps section, Gotcha section, and Constraints against the AIDB Skills Masterclass framework to produce a structured quality report.

The 5 Skill Killers to check are vague descriptions, over-defined processes, stating the obvious, missing gotchas, and monolithic blobs. Auditing catches these to ensure robust skill anatomy.

You validate frontmatter by checking for loud, specific name and description fields, and validate step structure by ensuring a numbered Steps section exists with explicit Constraints and context binding.

Yes, the audit verifies in-folder references, scoping, and identity/role considerations to ensure the skill's context binding is accurate and properly constrained within the repository.

To fix a monolithic blob, run a quality audit to identify missing anatomy elements like Steps, Output, and Gotcha sections, then refactor the skill into a structured, scoped format.