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

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:

---
name: DeployStaging
---

Good (in a directory named deploy-staging/):

---
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

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.