qms-audit-expert

I took a look at your QMS audit skill and noticed the spec compliance gaps are pulling the grade down—specifically around the progressive disclosure structure and how the reference materials are organized. The rubric seems solid for evaluation, but the skill's architecture feels like it's doing too much upfront before guiding users through the audit workflow step by step.

Links:

• GitHub
• Your agentic skill in the SkillzWave marketplace

The TL;DR

You're at 62/100, solidly in D territory. Based on Anthropic's 5-pillar rubric for agentic skills, you've got strong fundamentals (Spec Compliance at 12/15), but Utility and Progressive Disclosure Architecture are dragging things down. The biggest miss: all 9 referenced files are empty placeholders, which tanks your Utility score from what could be 18-20 down to 10.

What's Working Well

• Trigger phrases are solid — "ISO 13485", "internal audit", "CAPA verification" map directly to real use cases
• Frontmatter is clean — Valid YAML, correct naming conventions (hyphen-case)
• Good structural intent — The framework of "Audit Preparation → Execution → Nonconformity Management" makes sense as a workflow

The Big One: Empty Reference Files Kill Your Utility Score

Here's the thing: Your SKILL.md references 5 reference files and 4 scripts, but only 3 placeholder files exist with zero actual content. This is a massive missed opportunity.

Why it matters: Users invoke this skill expecting actionable guides (like iso13485-audit-guide.md with actual audit checklists), templates, and scripts. Instead they get pointers to empty files. That tanks Utility from potential 18/20 down to 10/20.

The fix:

• Create references/iso13485-audit-guide.md — Provide clause-by-clause audit methodolo...