Update skill-development SKILL.md with complete frontmatter reference#37648
Update skill-development SKILL.md with complete frontmatter reference#37648topspinj wants to merge 1 commit intoanthropics:mainfrom
Conversation
The frontmatter docs were outdated: name and description were marked as required (they're optional), version was shown in examples (not a real field), and many fields were missing. Add a complete reference table covering all 11 frontmatter fields and fix accuracy throughout. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
trev-gulls
left a comment
trev-gulls
left a comment
There was a problem hiding this comment.
Hey @topspinj, thanks for working on this update. I have run into similar issues with the skill-dev skill not pulling in an up-to-date metadata schema. I don't think I'm authorized to approve PRs in this repo, otherwise I would. I left one comment about future-proofing this skill against further schema changes.
| All frontmatter fields are optional. Only `description` is recommended so Claude knows when to use the skill. | ||
|
|
||
| | Field | Required | Description | |
There was a problem hiding this comment.
Should a link to https://code.claude.com/docs/en/skills#frontmatter-reference be included in case the docs are updated again?
There was a problem hiding this comment.
Thanks for the suggestion. I'm leaning toward leaving it out - the docs URL could change over time and become stale.
I'm not too opinionated on this though - I'll let the Anthropic team decide.
@dhollman would you be able to review this documentation update?
2 participants
Summary
Update the skill-development SKILL.md to reflect the latest frontmatter args as documented at https://code.claude.com/docs/en/skills.
name,description,argument-hint,disable-model-invocation,user-invocable,allowed-tools,model,effort,context,agent,hooks)nameanddescriptionbeing incorrectly marked as required (they're optional)versionfrom example frontmatter (not a valid field)Test plan
🤖 Generated with Claude Code