Index of every page on this site: llms.txt
All skills
juliusbrussee avatar

/caveman-help

@bad48a0
by Julius Brusseejuliusbrussee/caveman114k stars
6,594
Run it yourself

Quick-reference card for the three caveman skills and their commands. Trigger: /caveman-help or "caveman help".

Requires /caveman /caveman-commit /caveman-review
Use this Skill: https://skilld.dev/gh/juliusbrussee/caveman/caveman-help

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈31 tokens for metadata: the name and description. ≈653 when used: this file. ≈272 more on demand in 1 file.

Description uses 1.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈126 characters, or 1.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Caveman Help

Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything. Output in caveman style.

Modes

Mode Trigger What change
caveman /caveman The voice. Answer first, no fluff, every fact kept. Default.
ultracave /ultracave (alias /caveman ultra) Grammar stripped. Fragments, one word when enough, each fact once.
megacave /megacave (alias /caveman wenyan) Classical Chinese 文言文. Far fewer characters, technical terms verbatim.

Mode stick until changed or session end. /caveman status reports current mode without changing it. Claude Code and the standalone OpenCode plugin read stored state; other hosts answer from the conversation and mark it (not tracked by this host).

Skills

Skill Trigger What it do
caveman-commit /caveman-commit Terse commit messages. Conventional Commits. ≤50 char subject.
caveman-review /caveman-review One-line PR comments: L42: bug: user null. Add guard.
caveman-compress /caveman-compress <file> Compress .md files to caveman prose. 33.2% fewer tokens on the repo's five test files.
caveman-help /caveman-help This card.

Deactivate

Say "stop caveman" or "normal mode". Resume anytime with /caveman.

Language

Keep user's language by default — reply in the language user writes, never switch regardless of example text or multilingual context elsewhere. Compress the style, not the language. Technical terms, code, commands, commit types, and exact error strings stay verbatim unless user ask for translation.

Configure Default Mode

Default mode = caveman. Change it:

Environment variable (highest priority):

export CAVEMAN_DEFAULT_MODE=ultracave

Config file (~/.config/caveman/config.json):

{ "defaultMode": "ultracave" }

For opt-in activation in Claude Code, set defaultMode to manual. Sessions start off; /caveman or talk like caveman activates caveman. off also disables bare-command activation. manual is a startup policy, not a mode. OpenCode still starts in caveman mode because its installer also supplies static activation rules.

Set "off" to suppress automatic and bare-command activation. Use "manual" when bare /caveman should activate.

Resolution: env var > repo config > user config > caveman. Legacy values lite, full, ultra, wenyan* still resolve.

More

Full docs: https://github.com/JuliusBrussee/caveman

Source: SKILL.md on GitHub

Skill behaviors

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

Third-party checks

No alerts15d4 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    The skill provides a quick-reference card for other 'caveman' skills and modes. It is purely informational and does not perform any file system modifications, network operations, or security-sensitive actions.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

  • ZeroLeaks6mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at bad48a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 3 weeks ago

README badge

README badge for juliusbrussee/caveman/caveman-help