Files
agent-skills/scripts
An-iddandClaude Opus 4.8 11bfec4d1f feat(scripts): enforce naming + description-trigger rules in skill validator
The validator claims to check skills "against the rules in
docs/skill-anatomy.md", but two rules that doc marks as Required were
never enforced:

- Directory names must be lowercase-hyphen-separated (Naming Conventions).
  Previously only `name === dirName` was checked, so `My_Skill/` passed.
- Descriptions must say *when* to use the skill, not just what it does
  (Required vs Recommended). Formalized in #167 but the validator was
  never updated to match.

Adds both as blocking checks. All 24 existing skills pass, so this is a
non-breaking guardrail. Closes the remaining gap in #233 (frontmatter,
name-match, and section checks already shipped in the original validator).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 10:53:21 +08:00
..