Skill Name Kebab Case
skill-name-kebab-case
info
experience: naming
spec: frontmatter
Skill name should be lower kebab-case.
Skill name should be lower kebab-case so it matches the skill directory name and stays portable.
Rule definition
The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.
skill-name-kebab-case:
title: Skill Name Kebab Case
reference: https://spotlight-rules.com/spec/rules/agent-skill/skill-name-kebab-case/
description: Skill name should be lower kebab-case so it matches the skill
directory name and stays portable.
message: Skill name should be lower kebab-case.
severity: info
given: $.frontmatter.name
then:
function: pattern
functionOptions:
match: ^[a-z0-9]+(?:-[a-z0-9]+)*$
tags:
- format:agent-skill
- spec:frontmatter
- experience:naming
prompt: "You are editing an Agent Skill document to satisfy the Spotlight API
governance rule 'skill-name-kebab-case' (Skill Name Kebab Case).
Requirement: Skill name should be lower kebab-case so it matches the skill
directory name and stays portable. To fix: Ensure the targeted value matches
the regular expression `^[a-z0-9]+(?:-[a-z0-9]+)*$`; rewrite any value that
does not. This rule is evaluated at the JSONPath `$.frontmatter.name` —
inspect every location it matches and correct only what violates the rule.
Make the smallest change that satisfies the rule, leave all unrelated
content, key order, comments, and formatting unchanged, and keep the
document valid Agent Skill. Return only the complete corrected document,
with no commentary."
AI fix prompt — send this to Claude, Gemini, or ChatGPT with your artifact to auto-fix this rule
You are editing an Agent Skill document to satisfy the Spotlight API governance rule 'skill-name-kebab-case' (Skill Name Kebab Case). Requirement: Skill name should be lower kebab-case so it matches the skill directory name and stays portable. To fix: Ensure the targeted value matches the regular expression `^[a-z0-9]+(?:-[a-z0-9]+)*$`; rewrite any value that does not. This rule is evaluated at the JSONPath `$.frontmatter.name` — inspect every location it matches and correct only what violates the rule. Make the smallest change that satisfies the rule, leave all unrelated content, key order, comments, and formatting unchanged, and keep the document valid Agent Skill. Return only the complete corrected document, with no commentary.
| Artifact | Agent Skill |
|---|---|
| Applies at (given) | $.frontmatter.name |
| Severity | info — educational by default; raise to warn/error to enforce |
| Reference | https://spotlight-rules.com/spec/rules/agent-skill/skill-name-kebab-case/ |