claude-code - 💡(How to fix) Fix [DOCS] Bundled skill docs still use `/simplify` and omit `/code-review [effort]`

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
RAW_BUFFERClick to expand / collapse

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:

PageLine(s)Context
https://code.claude.com/docs/en/commands25, 112Summary text and full command row still document /simplify
https://code.claude.com/docs/en/skills14, 23Bundled skills overview still lists /simplify as current
https://code.claude.com/docs/en/features-overview246Features overview still cites /simplify as a bundled skill
https://code.claude.com/docs/en/glossary59Glossary 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.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Bundled skill docs still use `/simplify` and omit `/code-review [effort]`