Context File Tune-up

A CLAUDE.md or AGENTS.md file is loaded into an agent's context on every task. Different agents and repos use different filenames, and some repos keep one as a symlink or compatibility alias to the other. Treat them as the same class of file: high-leverage repo instructions for coding agents. A good one silently prevents whole classes of mistakes; a bloated or vague one wastes the context budget and gets ignored. This skill audits the target context file against a known-good structure, derives what it should contain by inspecting the repo, proposes a full rewrite, and applies it only after the user confirms.

The core loop is inspect → audit → propose → confirm → apply. Never skip the confirm step — this file encodes human judgment about a codebase, so the user gets the final say before anything is written.

What "good" looks like