[DOCS] Bundled skill docs still use `/simplify` and omit `/code-review [effort]`

Resolved 💬 2 comments Opened May 21, 2026 by coygeek Closed May 23, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

The "Before you ship" summary and the /simplify [focus] command entry in the commands reference.

Current Documentation

The docs currently say:

Before you ship. /diff shows what changed, /simplify reviews recent files and applies quality and efficiency fixes, and /review or /security-review give a deeper read-only pass.
| /simplify [focus] | Skill. Review your recently changed files for code reuse, quality, and efficiency issues, then fix them. Spawns three review agents in parallel, aggregates their findings, and applies fixes. Pass text to focus on specific concerns: /simplify focus on memory efficiency |

Related pages also still describe /simplify as a current bundled skill.

What's Wrong or Missing?

In v2.1.146, the release notes say this command was renamed from /simplify to /code-review and now supports an optional effort level such as /code-review high.

The current Claude Code docs still present /simplify as the active bundled skill and do not document the renamed /code-review command or its optional effort-level argument. That leaves the primary command reference out of sync with current behavior and makes the surrounding skills/glossary pages stale as well.

Suggested Improvement

Update the command reference and the related bundled-skill references to use the current command name and argument shape from v2.1.146.

Before:

/simplify [focus]

After:

/code-review [effort-level]

Also update the surrounding description and example to show the renamed command and an effort-level example such as /code-review high, then replace stale /simplify mentions on the related overview pages that describe current bundled skills.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 25, 112 | Summary text and full command row still document /simplify |
| https://code.claude.com/docs/en/skills | 14, 23 | Bundled skills overview still lists /simplify as current |
| https://code.claude.com/docs/en/features-overview | 246 | Features overview still cites /simplify as a bundled skill |
| https://code.claude.com/docs/en/glossary | 59 | Glossary entry for bundled skills still uses /simplify as a current example |

Total scope: 4 pages affected

The existing https://code.claude.com/docs/en/code-review page is about the GitHub Code Review product, so it does not currently document the renamed local slash command introduced in v2.1.146.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗