Сжимает текстовые файлы памяти и todo-списки в краткий caveman-формат, чтобы экономить input tokens. Исходный файл заменяется сжатой версией, а читаемая копия сохраняется отдельно.

Возможности

Обрабатывает файлы .md, .txt, .typ, .typst, .tex и файлы без расширения.
Удаляет лишние слова и сокращает формулировки, сохраняя структуру Markdown.
Не меняет код, команды, пути, ссылки, технические термины и содержимое в backticks.
Для файлов со смешанным текстом и кодом сжимает только текстовые части.
Сохраняет резервную копию вне исходной папки: в $XDG_DATA_HOME/caveman-compress/backups/<parent-dir-name>/ или в %LOCALAPPDATA%\caveman-compress\backups\<parent-dir-name>\ на Windows.
Проверяет результат и при ошибках делает до двух точечных исправлений. Если они не помогают, сообщает об ошибке и оставляет исходный файл без изменений.

Когда использовать

Нужно уменьшить объём CLAUDE.md или другого файла памяти, загружаемого agent.
Нужно сократить todo-список, предпочтения или заметки в текстовом файле.
Нужно убрать лишний текст, не меняя команды, код и структуру документа.

Примеры

Запуск через команду skill:

/caveman-compress /path/to/CLAUDE.md

Запуск CLI из директории с SKILL.md:

python3 -m scripts <absolute_filepath>

Пример сокращения текста:

Run tests before push to main. Catch bugs early, prevent broken prod deploys.

Установка

npx skills add https://github.com/juliusbrussee/caveman --skill caveman-compress