AGENTS.md / CLAUDE.md Optimize

Overview

agentsmd-audit reports and stops. This skill goes one step further: it audits, proposes a prioritized fix list, and applies the fixes the user approves directly to the file. Use it when the user wants the doc improved, not just graded.

The quality bar is the same five patterns + four anti-patterns from agentsmd-audit. This skill adds the editing discipline: which files are safe to touch, which regions are off-limits, and how to confirm before writing.

Operating Contract

Audit first, edit second. This skill modifies high-context files (CLAUDE.md, AGENTS.md, hooks, settings) — treat every write as gated.

Direct actions:

• Run read-only discovery: ls paths, check commands against manifests, measure auto-injected rule volume.
• Produce a scored audit and a prioritized fix list with evidence.
• Apply fixes the user has explicitly approved (or already said "做吧 / apply them" for).