Skip to main content

require-valid-skill-directory-name

Require Copilot skill directory names to use the documented lowercase-hyphen form.

Rule catalog ID: R049

Targeted pattern scope​

  • .github/skills/**/SKILL.md
  • .claude/skills/**/SKILL.md

What this rule reports​

  • skill directory names that use spaces, uppercase letters, or other unsupported characters

Why this rule exists​

Skill directories are part of the documented skill layout. Keeping those directory names lowercase and hyphenated makes the on-disk structure match published guidance and avoids path portability issues.

❌ Incorrect​

.github/skills/Review Skill/SKILL.md

✅ Correct​

.github/skills/review-skill/SKILL.md

Further reading​