Quality Program
Verified Plugins
Every plugin is automatically scored on a 100-point scale. Plugins that meet quality thresholds earn Gold, Silver, or Bronze verification badges.
Verification Tiers
Gold (90-100)
Production-ready. Meets all quality standards with excellence.
- Complete frontmatter (name, description, version, author, allowed-tools)
- Description includes trigger phrases and action verbs
- All required sections present (Overview, Instructions, Output, Error Handling, Examples)
- Reference files exist and are non-stub
- Scripts are non-stub implementations
- No security warnings
- Proper tool permissions declared
Silver (75-89)
Good quality. Meets core standards with minor gaps.
- Valid frontmatter with required fields
- Most recommended sections present
- Reasonable description length and quality
- Basic documentation included
- Minor warnings acceptable (e.g., missing optional sections)
Bronze (60-74)
Functional. Meets minimum quality bar for inclusion.
- Valid YAML frontmatter
- Name and description present
- Basic instructions provided
- Passes CI validation (no errors)
Scoring Rubric (100 Points)
Automated scoring by validate-skills-schema.py across 5 categories.
| Category | Points | What's Checked |
|---|---|---|
| Frontmatter | 30 | Required fields (name, description, version, author), trigger phrases, action verbs, tool permissions, author email |
| Structure | 25 | Required sections (Overview, Instructions, Output, Error Handling, Examples, Resources), section depth, content length |
| Content Quality | 25 | Non-stub scripts, valid reference files, README completeness, code examples present |
| Documentation | 10 | Word count adequacy, line count, section ordering, prerequisites listed |
| Best Practices | 10 | Proper tool declarations, description budget, naming conventions, no security anti-patterns |
Grade Distribution
Letter grades map to verification tiers.
A
90-100
Gold
B
75-89
Silver
C
60-74
Bronze
D
40-59
No badge
F
0-39
No badge
How to Check Your Score
# Score all skills
python3 scripts/validate-skills-schema.py --verbose
# Score a specific plugin
python3 scripts/validate-skills-schema.py --verbose --skills-only 2>&1 | grep "your-plugin"
# Fail CI if below Silver
python3 scripts/validate-skills-schema.py --min-grade B
# Show only low-scoring skills
python3 scripts/validate-skills-schema.py --show-low-grades