---

date: 2026-06-03 tags: [skills, claude-code, naming] status: graduated graduated_to: .claude/skills/build-claude-skill/SKILL.md

A skill's command name is its directory, not its name: frontmatter

Symptom — wanted /check…-discoverable aliases for skills; assumed a name: change or an aliases: field would surface them in autocomplete. It wouldn't.

Root cause — Claude Code has no alias field. The /-autocomplete and invocation key off the directory name; name: is a display label only. (Confirmed against current Claude Code docs.)

Fix — to rename or "alias" a skill, git mv the directory and set name: to match it; keep (formerly old-name) in the description for traceability. Wrapper-alias skills are not a supported pattern.

Guard — build-claude-skill's frontmatter rule: "name: MUST equal the directory name … renaming a skill = git mv the directory."