| Skill Directory | SKILL.md, references/, scripts/, assets/ | | Skill Type | Builder, Guide, Automation, Analyzer, or Validator | | Conversation | Validation purpose (audit, improvement, review) |
| SKILL.md exists | Root file present | | Line count | <500 lines (context is precious) | | Frontmatter complete | name and description present in YAML | | Name constraints | 1-64 chars; lowercase alphanumeric + hyphens; no consecutive hyphens; can't start/end with hyphen; must match directory name |
| Description format | [What] + [When] format; ≤1024 chars | | Description style | Third-person: "This skill should be used when..." | | No extraneous files | No README.md, CHANGELOG.md, LICENSE in skill dir | | Progressive disclosure | Details in references/, not bloated SKILL.md | | Asset organization | Templates in assets/, scripts in scripts/ |