SKM-N02 · Error
`name` is longer than 64 characters
The specification caps `name` at 64 characters.
What the rule is
The specification caps `name` at 64 characters. This is a hard constraint in the field table, not a recommendation — unlike the body-length guidance in SKM-B01, there's no softer framing here.
In practice this is rarely a problem for a genuinely descriptive name; it usually shows up when a name has been written as a short sentence rather than a short identifier.
Where it comes from
- Agent Skills — SpecificationSpecification
Which runtimes enforce it
| Runtime | Effect | Note |
|---|---|---|
| Claude Code | Not documented | The spec states the limit; no runtime documents what happens to a skill whose name exceeds it. |
| Codex | Not documented | The spec states the limit; no runtime documents what happens to a skill whose name exceeds it. |
| Cursor | Not documented | The spec states the limit; no runtime documents what happens to a skill whose name exceeds it. |
| OpenClaw | Not documented | The spec states the limit; no runtime documents what happens to a skill whose name exceeds it. |
| Hermes Agent | Not documented | The spec states the limit; no runtime documents what happens to a skill whose name exceeds it. |
How to fix it
- Shorten `name` to 64 characters or fewer. It only needs to identify the skill, not describe it — that's what `description` is for.
Elsewhere
- SKILL.md, the formatThe full frontmatter field table this rule is drawn from.
- Agent Skills Not WorkingThe diagnostic reference this rule’s portability and failure evidence comes from.
- All rulesEvery check the validator runs, grouped by class.