← X

New in Claude Code: /checkup Run /checkup to: 1. Clean up unused skills/MCPs/p

X · bcherny · July 8, 2026
Claude Code introduced a new /checkup command that performs multiple code organization and cleanup tasks. The command cleans up unused skills, MCPs, and plugins while saving context, deduplicates local and checked-in CLAUDE.md files, breaks up root files into nested structures, and turns off slow hooks.

Detailed Analysis

Anthropic has introduced a new slash command, `/checkup`, to Claude Code, its command-line coding agent, aimed at helping developers maintain and optimize their local development environments. The feature functions as an automated housekeeping utility that scans a user's Claude Code setup and performs a series of maintenance tasks: removing unused skills, MCP (Model Context Protocol) servers, and plugins that may be consuming context space; deduplicating a developer's local CLAUDE.md configuration file against the version checked into version control; restructuring an overly large root-level CLAUDE.md file into smaller, nested CLAUDE.md files paired with modular skills; disabling hooks that are slowing down performance; and prompting updates to the Claude Code application itself.

The introduction of `/checkup` addresses a practical problem that has emerged as Claude Code's ecosystem has matured: configuration sprawl. As developers accumulate MCP integrations, custom skills, plugins, and increasingly elaborate CLAUDE.md files (which serve as persistent instructions and context for the agent), these accumulations can silently degrade performance by consuming valuable context window space and slowing down agent responses through unnecessary hook execution. This is a familiar pattern in software tooling—as a platform's extensibility grows, so does the need for garbage collection and configuration hygiene tools. By automating this maintenance rather than requiring manual auditing, Anthropic is reducing the operational burden on developers who might otherwise let cruft accumulate indefinitely, degrading their agent's effectiveness without a clear signal as to why.

The specific mention of CLAUDE.md restructuring—breaking a single root file into nested files and skills—reflects a broader design philosophy Anthropic has been pushing around context engineering. Rather than treating an AI coding agent's instructions as a single monolithic prompt, the trend is toward modular, hierarchical context that can be loaded selectively depending on which part of a codebase or task is relevant. This mirrors software engineering best practices around separation of concerns and lazy loading, applied now to the "prompt layer" of agentic systems. Deduplicating local versus checked-in CLAUDE.md files also speaks to the reality that Claude Code is increasingly used in team settings, where shared configuration files can drift from individual developers' local overrides, creating inconsistency across a team's tooling.

More broadly, this update fits into Anthropic's rapid iteration cadence on Claude Code throughout 2025 and into 2026, during which the product has evolved from a simple terminal-based coding assistant into a more sophisticated agentic development environment with plugins, subagents, hooks, and an expanding MCP ecosystem. As competition intensifies among AI coding tools—including offerings from OpenAI, Google, Cursor, and others—incremental quality-of-life features like `/checkup` signal that Anthropic is focusing not just on raw model capability but on the operational maturity and maintainability of the surrounding developer experience. This is characteristic of a broader industry shift in agentic AI tooling: as these systems become more complex and customizable, self-diagnostic and self-optimizing capabilities become essential to keeping them usable, performant, and trustworthy over time rather than accumulating technical debt that erodes their value.

Read original article →