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	agentskills, dot-claude, 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.

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.