[DOCS] Skills docs omit accepted casing variants for skill frontmatter keys

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/skills

Section/Topic

"Frontmatter reference"

Current Documentation

The Skills page says:

"Beyond the markdown content, you can configure skill behavior using YAML frontmatter fields between --- markers at the top of your SKILL.md file"

The frontmatter reference lists keys such as:

"allowed-tools"

and:

"disallowed-tools"

The plugin reference separately documents camelCase plugin manifest keys such as:

"displayName"

and:

"defaultEnabled"

What's Wrong or Missing?

Claude Code v2.1.186 improved skill frontmatter so display-name, default-enabled, fallback, and metadata.* keys accept kebab-case, snake_case, and camelCase.

The Skills page does not mention those key aliases or the casing normalization rule. Authors may assume only the casing shown in the table is accepted.

Suggested Improvement

Add a note to the frontmatter reference:

Skill frontmatter keys are normalized for the supported metadata fields. For display-name, default-enabled, fallback, and metadata.*, Claude Code accepts kebab-case, snake_case, and camelCase forms.

Include examples:

display-name: Code Reviewer
default_enabled: false
metadata.owner: docs-team

If some frontmatter keys do not accept aliases, list the exception explicitly.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/skills | Skill SKILL.md frontmatter reference |
| https://code.claude.com/docs/en/plugins-reference | Related plugin metadata fields use camelCase examples |

Total scope: 2 pages affected