[DOCS] Skills and plugin docs omit accepted string values for frontmatter booleans

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The skill frontmatter reference and the corresponding plugin frontmatter/reference examples for boolean fields.

Current Documentation

The Skills page documents boolean-looking fields using YAML examples such as:

disable-model-invocation: Set to true to prevent Claude from automatically loading this skill.

and:

user-invocable: Set to false to hide from the / menu.

The documentation does not list any accepted alternatives to true and false or state whether values are case-sensitive.

What's Wrong or Missing?

Claude Code 2.1.218 added case-insensitive yes, no, on, off, 1, and 0 as accepted values for skill and plugin frontmatter booleans, alongside true and false.

The current examples make the accepted syntax appear narrower than it is. Authors who use common YAML-style on/off or string-based configuration generation cannot tell whether those values are valid, normalized, or rejected.

Suggested Improvement

Add a frontmatter boolean note to the Skills page and the plugin reference:

Boolean frontmatter fields accept true, false, yes, no, on, off, 1, and 0, case-insensitively. The values are normalized to a boolean before Claude Code applies the field.

Show equivalent examples such as disable-model-invocation: off and user-invocable: 0, and clarify whether quoted and unquoted forms are both accepted. Keep the existing canonical true/false examples as the recommended style.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/skills | Skill frontmatter fields and YAML examples |
| https://code.claude.com/docs/en/plugins-reference | Plugin component frontmatter and validation |
| https://code.claude.com/docs/en/plugins | Plugin authoring examples |

Total scope: 3 pages should share the same boolean-value contract.

The behavior was added in Claude Code v2.1.218.