caveman-compress

Compress agent state files into a compact caveman format.

14|1|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/galeka/GAIA-Obsidian-Vault --skill caveman-compress-galeka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-compress
Source: https://github.com/galeka/GAIA-Obsidian-Vault/tree/main/skills/caveman-compress
Command: npx skills add https://github.com/galeka/GAIA-Obsidian-Vault --skill caveman-compress-galeka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the issue of bloated state files in the GAIA Obsidian Vault by compressing them into a more compact caveman format, reducing input tokens without losing any technical substance.

Core Features & Use Cases

  • Compress State Files: Converts state files into caveman format to minimize input tokens per session.
  • Preserve Data: Keeps all essential elements, such as code, URLs, paths, and structure.
  • Backup: Generates a human-readable backup of the original file.
  • Trigger: Use /caveman-compress FILEPATH or "compress this file" to initiate compression.
  • Safe to Use: Designed for operational state files only; do not use on vault note content.

Quick Start

Compress the agent state file 'agent-state.md' by typing: /caveman-compress agent-state.md

Frequently Asked Questions about caveman-compress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce input tokens for agent state files?

To reduce input tokens for agent state files, compress them into a compact caveman format. This minimizes token usage per session while preserving all essential technical elements like code, paths, and URLs.

How do I compress a state file without losing technical substance?

Compressing a state file without losing technical substance involves converting it into a caveman format. This compact representation retains all code, URLs, paths, and structural elements while significantly reducing the overall token count.

Does state compression generate a backup of the original agent file?

Yes, state compression generates a human-readable backup of the original agent file. This ensures you can safely revert to the uncompressed version after the conversion to the caveman format is complete.

Can I compress vault note content using this state file compression method?

No, you cannot compress vault note content with this method. It is designed exclusively for operational state and dispatcher files, and should not be used on vault note content to avoid unintended data alteration.

What is the best way to lower session load on dispatcher files?

The best way to lower session load on dispatcher files is to compress them into a caveman format. This reduces the input tokens required per session, lightening the processing load without stripping technical substance.