AeroMc-Launcher/.claude/skills/caveman-learn/README.md

caveman-learn skill

Close the loop on caveman learn. The command finds where your agent's tokens go; this skill walks through the findings with you and applies the fixes, one approved edit at a time.

Install

caveman skills install caveman-learn            # this repo's .claude/skills
caveman skills install caveman-learn --user      # all repos (~/.claude/skills)
caveman skills install caveman-learn --agent codex

What it does

1. Runs caveman learn report --json and shows your Setup Score and the findings, biggest first.
2. For each finding you pick, it proposes a fix and asks yes or no:
   • Safe fix (a heavy CLAUDE.md, a skill you never use): a concrete trim. It is kept only if it measurably makes every message smaller.
   • Repeated text (text you paste again in session after session): move it to Caveman memory (cavemem). The full text is stored once, the agent recalls a short version when it needs it, and a small pointer stays behind. Kept only when it beats pasting, and only after a test recall proves the text still comes back.
   • Needed (setup your agent relies on): never touched.

After an approved edit passes its re-check, caveman learn applied <id> records which finding was fixed, how, when, and its size before. Later scans compare the sessions after the fix and report improved, unchanged, regressed, or insufficient_data (not enough sessions yet). This record does not edit your own or your repository's files.

Honesty

Everything is an estimate (inferred): no currency, never "verified". Every edit waits for your yes and can be undone. A move to memory that would leave the agent unable to recall the text is rejected. caveman learn itself never edits your files; this skill does, and only with your yes.