Skill Single Title
skill-single-title
info
experience: consistency
spec: body
Skill body should have at most one level-1 heading.
A skill body should have at most one level-1 heading — the frontmatter name is the title, and sections should use level-2 headings.
Rule definition
The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.
skill-single-title:
title: Skill Single Title
reference: https://spotlight-rules.com/spec/rules/agent-skill/skill-single-title/
description: A skill body should have at most one level-1 heading — the
frontmatter name is the title, and sections should use level-2 headings.
message: Skill body should have at most one level-1 heading.
severity: info
given: $
then:
function: headingCount
functionOptions:
depth: 1
max: 1
tags:
- format:agent-skill
- spec:body
- experience:consistency
prompt: "You are editing an Agent Skill document to satisfy the Spotlight API
governance rule 'skill-single-title' (Skill Single Title). Requirement: A
skill body should have at most one level-1 heading — the frontmatter name is
the title, and sections should use level-2 headings. 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-single-title' (Skill Single Title). Requirement: A skill body should have at most one level-1 heading — the frontmatter name is the title, and sections should use level-2 headings. 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) | $ |
| Severity | info — educational by default; raise to warn/error to enforce |
| Reference | https://spotlight-rules.com/spec/rules/agent-skill/skill-single-title/ |