# Skill Quality Standards

> Use when defining quality standards for skills.

- Skill: `loopyluci/skill-quality-standards` (Agent Skill)
- Install (CLI): `npx skillmds@latest add loopyluci/skill-quality-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/loopyluci/skill-quality-standards/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: LoopyLuci (https://skillmd.com/u/loopyluci)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/loopyluci/skill-quality-standards

---


# Skill Quality Standards

Defining and enforcing quality standards for Hermes skills — from frontmatter validation and description rules through code verification, documentation completeness, and review checklists.

## When to Use

- Creating new skills that meet quality standards
- Reviewing existing skills for quality compliance
- Establishing team-wide skill authoring conventions
- Automated quality gates for skill contributions

## Quality Dimensions

```python
QUALITY_DIMENSIONS = {
    'frontmatter': 'Valid YAML, required fields, proper tags',
    'description': '≤60 chars, "Use when" prefix, ends with period',
    'content': 'Executable code, clear sections, practical examples',
    'verification': 'Checklist items are testable, not aspirational',
    'references': 'Related skills exist and are accurately referenced',
}
```

## Best Practices

```python
SKILL_BEST_PRACTICES = {
    'naming': 'Lowercase, hyphens (kebab-case), max 64 chars',
    'description': 'Start with "Use when", fit 60 chars, end with period',
    'frontmatter': 'Include tags (3-8), version, author, full metadata',
    'organization': 'Clear sections: When to Use → Core → Pitfalls → Checklist',
    'code': 'Executable patterns (not just description), runnable examples',
    'pitfalls': '5-6 specific, actionable failure modes with explanations',
    'checklist': '5-10 testable items (not "think about X", rather "X is configured")',
    'see_also': '3-5 related skills that complement this one',
}
```

## Verification Checklist

- [ ] Description starts with "Use when" and fits 60 chars
- [ ] Frontmatter has all required fields (name, description, version, author, tags)
- [ ] Skill has Common Pitfalls section with ≥4 actionable items
- [ ] Skill has Verification Checklist with testable items
- [ ] Code examples syntactically correct
- [ ] See Also references existing skills
- [ ] Tags are relevant (3-8 tags)
- [ ] Skill name is lowercase kebab-case