thinning-agent-instructionslisted
Install: claude install-skill bim-ba/ai
# Thinning Agent Instructions
Bring a project `CLAUDE.md` into the canonical 10-section skeleton by removing content the shared home layers already provide, keeping ONLY project-specific facts. This is the FIX companion to `reviewing-agent-instructions` (which audits and reports but never edits).
## Purpose
### What this skill enables
A project `CLAUDE.md` is paid on every single turn's context. Anything it repeats from a shared always-on layer is pure overhead. This skill relocates that generic content to where it belongs (or deletes it because the layer already carries it) and reshapes what remains into the canonical skeleton - so the file holds only what is TRUE HERE and would surprise an agent applying defaults.
### When to use it
- A `CLAUDE.md` carries a generic "Agent Behaviour Protocol", "Communication Style"/voice spec, or generic git/secrets/tooling/orchestration rules that duplicate the home layers.
- A `CLAUDE.md` predates the 10-section skeleton (`templates/CLAUDE.md.tmpl`) and needs restructuring.
- Onboarding an existing project to the standard, or acting on a `reviewing-agent-instructions` audit that flagged oversize/duplication.
### When NOT to use it
- The `CLAUDE.md` is already thin and skeleton-conformant - use `Edit` for a small tweak.
- To CHANGE project rules - this preserves them; it only relocates the generic ones.
- On project content / research / docs - those are not the agent-instruction surface.
## Pre-checks
1. **Know the home layers**