pandora/web/.agents/skills/caveman-learn/README.md

1.3 KiB

caveman-learn skill

Close the loop on caveman learn. The command measures where your agent's tokens go; this skill reviews that plan 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 Cave Score + ranked token sinks.
  2. For each sink you pick, proposes a fix and asks yes/no:
    • reducible (heavy CLAUDE.md, never-invoked skill) → a concrete trim, applied only if it measurably lowers tokens/turn.
    • recurring_context (context you re-establish every session) → offload it to cavemem (cavemem_offload): stored raw, compacted at recall on demand, with a cheap pointer left behind. Applied only when it beats re-pasting, and only after a confirming recall proves the content still comes back.
    • load_bearing → never touched.

Honesty

Everything is inferred — no currency, no "verified". Every edit is consent-gated and reversible, and an offload that would leave the agent unable to recall the content is rejected. The analyzer never edits your files; this skill does, only with your yes.