[DOCS] Skills docs missing `effort` frontmatter field for overriding model effort level

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

Frontmatter reference table listing available frontmatter fields for skills and slash commands

Current Documentation

The skills page documents these frontmatter fields in its reference table:

name, description, argument-hint, disable-model-invocation, user-invocable, allowed-tools, model, context, agent, hooks

The effort field is absent from this table. There is no mention of effort overrides anywhere in the skills documentation.

What's Wrong or Missing?

Changelog v2.1.80 added effort frontmatter support for skills and slash commands to override the model effort level when invoked. This field is not documented in the skills frontmatter reference table.

The effort frontmatter field is distinct from:

• The /effort slash command (session-scoped, documented in commands.md)
• The --effort CLI flag (session-scoped, documented in cli-reference.md)
• The effortLevel settings key (persistent, documented in settings.md)

This new frontmatter field allows skill authors to specify that a particular skill should always run at a specific effort level (e.g., effort: high for complex analysis skills), regardless of the user's session-level setting.

Suggested Improvement

Add an effort row to the frontmatter reference table:

| Field | Description |
|-------|-------------|
| effort | Override the model effort level when this skill or slash command is invoked. Values: low, medium, high, max. |

Include a brief example:

---
name: deep-analysis
description: Thorough code analysis
effort: high
---

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/skills | Frontmatter reference table |

Total scope: 1 page affected

Source: Changelog v2.1.80

Added effort frontmatter support for skills and slash commands to override the model effort level when invoked