caveman-learn SKILL.md skillA

caveman-learn from juliusbrussee/caveman is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add juliusbrussee/caveman/caveman-learn@git:20261014.f5837c4

Pins git:20261014.f5837c4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
juliusbrussee/caveman
Path
skills/caveman-learn/SKILL.md
Versions recorded
7
Latest version
git:20261014.f5837c4, committed Oct 14, 2026
First version recorded
Aug 11, 2026
Size
11,515 bytes
Repository stars
118,366
License
Apache-2.0

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

You are the Caveman Learn editing skill. The "caveman learn" command MEASURES where
an agent's tokens go; you are the consent-gated half that turns its findings into
edits — with the user approving each one. You never claim a saving you have not
measured, and you never make the agent dumber.

New sinks you may see, and what they are for:
- cache_efficiency — what a million input tokens actually cost after cache reuse. It is
  a RATE the other sinks are priced at, not a volume; never add it to anything.
- tool_output_portfolio — the call shapes that dominate context, ranked.
- session_outcomes — the share of tokens in sessions with no commit in their window.
  Correlational. Present it as an observation and read its caveat out loud; a session
  without a commit is not a wasted session.
- subagent_spend — the share of context that ran in subagents. Visibility only. Do not
  turn it into advice to spawn fewer subagents.
- procedure_repeat:* — a distillation candidate. See SKILL_DISTILLATION below.

Read the plan first:

1. Run: caveman learn report --json
   Parse the caveman.learn.v1 JSON. Show the Cave Score, its four components, and the
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add juliusbrussee/caveman/caveman-learn@sha256:05e803e8024786b4

The line at the top of this page pins the label git:20261014.f5837c4, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wkkcvjaqdbtzumtr.svg)](https://markdownregistry.com/a/art_wkkcvjaqdbtzumtr)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Aug 11, 2026 and Oct 14, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261014.f5837c4 latest2026-10-14 f5837c4 11,515 BA view · diff
git:20260928.0e2fee32026-09-28 0e2fee3 11,370 BA view · diff
git:20260928.18f9e252026-09-28 18f9e25 10,928 BA view · diff
git:20260823.8909f6a2026-08-23 8909f6a 9,205 BA view · diff
git:20260823.4e0f49b2026-08-23 4e0f49b 9,366 BA view · diff
git:20260817.5e3d6b82026-08-17 5e3d6b8 4,837 BA view · diff
git:20260811.82864c82026-08-11 82864c8 4,375 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11515 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

juliusbrussee/caveman · 118,366 stars · license Apache-2.0 · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wkkcvjaqdbtzumtr
GET https://markdownregistry.com/api/v1/resolve?ref=juliusbrussee/caveman/caveman-learn
GET https://markdownregistry.com/api/v1/blob/05e803e8024786b4abf78cb89ccbd6aa3834a042f398fc84a69f5652368b2d0a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from juliusbrussee/caveman

AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars
CLAUDE.md CLAUDE.md file
juliusbrussee/caveman · CLAUDE.md
git:20261106.af560e1 · audit B · 118,366 stars
CLAUDE.md@browse CLAUDE.md file
juliusbrussee/caveman · browse/CLAUDE.md
git:20260816.f71f6df · audit A · 118,366 stars
AGENTS.md@engine AGENTS.md file
juliusbrussee/caveman · engine/AGENTS.md
git:20260812.d4ef06b · audit A · 118,366 stars
CLAUDE.md@engine CLAUDE.md file
juliusbrussee/caveman · engine/CLAUDE.md
git:20261106.3dfdbd1 · audit A · 118,366 stars
AGENTS.md@extension AGENTS.md file
juliusbrussee/caveman · extension/AGENTS.md
git:20261003.2ec7194 · audit A · 118,366 stars
CLAUDE.md@extension CLAUDE.md file
juliusbrussee/caveman · extension/CLAUDE.md
git:20261003.2ec7194 · audit A · 118,366 stars
CLAUDE.md@integrations CLAUDE.md file
juliusbrussee/caveman · integrations/CLAUDE.md
git:20260812.d4ef06b · audit A · 118,366 stars
AGENTS.md@mcp AGENTS.md file
juliusbrussee/caveman · mcp/AGENTS.md
git:20260924.921eab8 · audit A · 118,366 stars
CLAUDE.md@mcp CLAUDE.md file
juliusbrussee/caveman · mcp/CLAUDE.md
git:20260924.921eab8 · audit A · 118,366 stars
AGENTS.md@mem AGENTS.md file
juliusbrussee/caveman · mem/AGENTS.md
git:20260924.921eab8 · audit A · 118,366 stars
CLAUDE.md@mem CLAUDE.md file
juliusbrussee/caveman · mem/CLAUDE.md
git:20261025.777bb73 · audit A · 118,366 stars

Every file in juliusbrussee/caveman

Other files named caveman-learn

caveman-learn SKILL.md skill
intrafind/ihub-apps · .claude/skills/caveman-learn/SKILL.md · Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and…
git:20260914.30914b9 · audit A · 26 stars

Browse by kind, by grade A, or by owner.