[DOCS] Settings reference missing `skillOverrides` setting and its `off` / `user-invocable-only` / `name-only` modes

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

settings.json available settings reference for skill visibility and invocation control

Current Documentation

No documentation currently exists for the skillOverrides setting in the settings reference.

The current docs only describe per-skill frontmatter controls:

By default, Claude can invoke any skill that doesn't have disable-model-invocation: true set. Hide individual skills by adding disable-model-invocation: true to their frontmatter. This removes the skill from Claude's context entirely.

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

The user-invocable field only controls menu visibility, not Skill tool access. Use disable-model-invocation: true to block programmatic invocation.

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

What's Wrong or Missing?

Claude Code v2.1.129 added working skillOverrides behavior with three modes:

A. The setting itself is undocumented

There is no skillOverrides entry in the settings.json reference, so users cannot discover that this setting exists or where it belongs.

B. The supported values and their effects are undocumented

The docs do not explain that:

• off hides a skill from both the model and the / menu
• user-invocable-only hides a skill from the model but keeps it user-invocable
• name-only collapses the description

C. The relationship to existing skill frontmatter is undocumented

The skills page documents disable-model-invocation: true and user-invocable: false, but it does not explain when a user should use skillOverrides instead of changing each skill's frontmatter.

Suggested Improvement

Add a skillOverrides entry to the settings reference with a concrete JSON example and value semantics.

Suggested addition:

{
"skillOverrides": {
"deploy": "user-invocable-only",
"legacy-system-context": "off",
"big-reference": "name-only"
}
}

Document each mode explicitly:

• off: hide the skill from the model and from /
• user-invocable-only: hide the skill from the model but keep it available via /
• name-only: keep the skill visible but collapse its description

Also add one short cross-reference from the skills page explaining that global settings can override discovery/visibility without editing each skill's SKILL.md.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | Missing skillOverrides setting from the settings.json reference |
| https://code.claude.com/docs/en/skills | Documents per-skill frontmatter controls, but not the settings-level override behavior |

Total scope: 2 pages affected

Observed against changelog entry for v2.1.129.