Optimise Claude

Audit AI instruction files for size, relevance, and structure. CLAUDE.md loads every session — bloated files cause Claude to ignore your actual instructions. SKILL.md lines cost tokens on every invocation. Keeping both lean reduces latency, cost, and instruction-following failures.

Scope

All operations scoped to project root ($PWD). Never modify files outside the repository.

When to Use

• CLAUDE.md is long and Claude ignores rules or asks questions already answered in it
• SKILL.md files exceed ~120 lines
• Frontmatter or section order is non-canonical
• Multiple skills contain duplicated content
• AGENTS.md has inline instruction blocks >30 lines that should be skills

Workflow

Run phases sequentially. Skip any that don't apply.