# agentskill-name Skill name must be lowercase letters, numbers, and hyphens and match directory name | | | |---|---| | **Severity** | error (auto) | | **Autofix** | auto | | **Since** | v0.1.0 | | **Repo Types** | agent-plugin, agentskills, antigravity-plugin, codex-marketplace, codex-plugin, dot-claude, grok-marketplace, grok-plugin, marketplace, single-plugin | | **Category** | [agentskills.io](agentskills.md) | ## Why Skill names are identifiers used in configuration, logging, and invocation commands. A name that does not match the directory name or uses non-kebab-case creates confusion — users and tools expect the skill name and its directory to correspond. ## Examples **Bad:** ```yaml --- name: DeployStaging --- ``` **Good (in a directory named `deploy-staging/`):** ```yaml --- name: deploy-staging --- ``` ## How to fix Rename the `name` field in SKILL.md frontmatter to match the skill's directory name, using lowercase letters, numbers, and hyphens (a leading digit is allowed, e.g. `1password`). `skillsaw fix` can correct the name automatically when a valid kebab-case name can be derived from it. Some violations need a manual rename and are reported without the `[*]` fixable marker: names with no Latin letters or digits to kebab-case (for example, a fully non-Latin name), a `name:` written as a block scalar or spread over multiple lines, duplicate `name:` keys, and directory mismatches where the directory name itself is not valid kebab-case (rename the directory instead). ## Configuration ```yaml rules: agentskill-name: enabled: auto # true | false | auto severity: error ``` *Run `skillsaw explain agentskill-name` to see this documentation and the rule's effective configuration in your terminal.*