Rework README layout and copy: reorder navbar links, rename sections (Levels, 文言文), simplify intensity triggers, and tighten many examples/phrasing. Add caveman-compress docs and compression benchmarks (file-savings table), move/reinsert API benchmark table, and replace long "Why/How" prose with concise benefits and visuals. Misc fixes: Wenyan wording, CLAUDE.md compress examples, and various formatting cleanup for clarity and token-efficiency.
Expand README with new features and docs: add TOC links for Skills and Evals, update intro to mention Wenyan mode/terse commits/reviews and compression tool, and consolidate Windows Codex install/symlink notes into a short note. Add a new Wenyan (文言文) section with levels and example, introduce Caveman Skills (caveman-commit and caveman-review) with usage examples and severity prefixes, and add an Evals section describing the eval harness and commands. Minor wording/ordering tweaks to installation text.
Separate language translations are unnecessary — Claude already responds
in the user's language. These added maintenance surface without real value.
Wenyan mode is kept as it's a genuinely different compression technique
built into the core skill.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Making the prefix optional matched every English word as a path.
Now requires either a path prefix (./ ../ / drive:) or contains / or \.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Positive savings (skill reduces tokens) should display as "+" not "−".
The sign logic was backwards, making all eval results misleading.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
These are build artifacts (HTML report and PNG plot) that should not be
version-controlled. Added evals/snapshots/*.html and *.png patterns to
.gitignore.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The Portuguese caveman skill was duplicated at both caveman-pt/SKILL.md (root)
and skills/caveman-pt/SKILL.md. Remove the root-level copy since skills belong
under the skills/ directory.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Closes#18 by replacing the unverified "~75% savings" claim with a real,
auditable measurement.
Methodology:
- Three arms per prompt: baseline (no system prompt), terse control
("Answer concisely."), and terse+SKILL.md. The honest delta is
skill vs terse — this isolates the skill's contribution from the
generic "be terse" effect.
- Real LLM in the loop via `claude -p --system-prompt`. No hand-written
baselines, no circularity.
- Snapshot of LLM outputs committed to git as the source of truth.
measure.py runs in CI with no network and no auth.
- Reports median, mean, min, max, stdev across prompts so noise is visible.
- Metadata pinned in the snapshot: model, CLI version, generation timestamp.
Initial run on claude-opus-4-6 (n=10 prompts) shows the real numbers
sit in the −22% to −49% mean range, not the previously claimed ~75%.
The README's headline number should be updated to match.
Add Portuguese localization of the caveman skill, following the same
structure as caveman-es and caveman-cn.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix PATH_REGEX in validate.py: The regex was incorrectly matching
relative paths like 'src/file.js' as 'rc/' instead of the full path.
Changed to use non-capturing group with optional prefix.
- Add safety check in compress.py: Prevent silent overwriting of
existing .original.md backup files. Now aborts with a warning
instead of overwriting potentially important backup content.
- Add proper module initialization in __init__.py: Previously empty,
now includes __all__ exports and __version__ for proper imports.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Update caveman-compress/SKILL.md name to 'compress' and trigger to '/caveman:compress'
- Create symlinks from compress/ (Claude Code) and plugins/caveman/skills/compress/ (Codex/npx) to caveman-compress/
- Single source of truth: caveman-compress/ holds all scripts and SKILL.md
- Update README to reflect compress as built-in skill
Fixes#33
Add skills/caveman-es/SKILL.md following the same structure as the
English caveman skill. Covers the same three intensity levels (lite,
full, ultra) with Spanish grammar rules and examples.
Technical terms stay in English (useMemo, connection pooling, etc.)
since that's how most Spanish-speaking devs use them. Only the
surrounding prose becomes terse Spanish caveman.
Fixes#8
Add project-level Cursor skill discovery support by introducing
`.cursor/skills/caveman/SKILL.md` as a copy of the canonical
`skills/caveman/SKILL.md`, without changing skill behavior.
Update the sync workflow to keep the new Cursor copy aligned with the
canonical source alongside existing synced targets, and include it in the
CI commit step. Also update CONTRIBUTING notes to document that this new
path is auto-synced and should not be edited directly.
github-actions[bot]