AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--caveman at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 4

references/companion_tooling.md

Companion Tooling

Compression tools + cs-* wrapper layered on top of Matt's caveman skill.

Validation Tools (stdlib Python)

| Tool | Purpose | Run when | |---|---|---| | scripts/caveman_compressor.py | Apply Matt's rules deterministically (drop articles/filler/pleasantries/hedging, abbreviate technical terms, use causality arrows) | Want a starting compressed version of any text | | scripts/token_savings_estimator.py | Estimate token + cost savings using 4 chars/token (prose) or 3.5 chars/token (technical) heuristic | Want to quantify the value of caveman mode | | scripts/caveman_lint.py | Detect banned vocabulary in a response (pleasantries, filler, hedging, metatalk, verbose phrases). Whitelist: code blocks, inline code, exception zones | Verify a response complies with caveman rules |

All three tools:

  • Stdlib-only (no external dependencies)
  • Run with embedded sample if no input provided
  • Output text or JSON (--output json)
  • Code blocks + inline code preserved (compression skips them)

Token-Savings Heuristic

The estimator uses character-per-token approximations:

  • 4.0 chars/token for English prose
  • 3.5 chars/token for technical text (detected by presence of {, }, (), ->, ==, //, etc.)

This is within 10-15% of cl100k_base / o200k_base tokenizers for English. For exact token counts use the model's actual tokenizer (e.g., tiktoken).

cs-caveman-mode Persona Agent

Lives at ../agents/cs-caveman-mode.md. Voice: terse, fragments-OK, no filler. Persistence is the hard rule — once activated stays active until "stop caveman" / "normal mode".

/cs-caveman Slash Command

Lives at ../commands/cs-caveman.md. Single-trigger activation. Equivalent to typing "caveman mode" but more explicit.

When Caveman Backfires (See main SKILL.md "Auto-Clarity Exception")

The compressor + lint tool both whitelist these zones — Matt's rule is explicit:

  • Security warnings
  • Irreversible action confirmations
  • Multi-step sequences where fragment order risks misread
  • User asks to clarify or repeats question

The lint tool detects **Warning:**, destructive, irreversible, cannot be undone markers and softens its verdict accordingly.

Why Wrap Matt's Original

Matt's caveman skill is tight + complete. The wrapper adds:

  1. Deterministic compression — apply rules consistently across responses (not just in spirit)
  2. Quantification — show ROI of caveman mode in tokens/dollars
  3. Compliance checking — verify a response actually follows rules (vs claiming to)

Attribution

Original: matt-pocock/skills/skills/productivity/caveman (MIT).


Source authorities (non-exhaustive):

  • Matt Pocock — caveman (https://github.com/mattpocock/skills/, MIT) — the upstream source
  • Anthropic — Token usage best practices (https://docs.claude.com/en/docs/build-with-claude/prompt-engineering) — token-conscious prompting
  • OpenAI tokenizer docs — tiktoken library + cl100k_base / o200k_base heuristics
  • Strunk & White — "The Elements of Style" (1918) — "omit needless words"; foundational text on prose compression
  • Plain Language Movement / Plain Writing Act of 2010 — federal mandate for concise government writing
  • Norman, D. — "Living with Complexity" (2010) — when simplicity helps vs hurts cognition
  • Pareto principle in communication — 20% of words carry 80% of information density