caveman-protocol

Compresses agent-to-agent messaging payloads via a five-phase channel-aware protocol.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/soli92/soli-projects --skill caveman-protocol-soli92
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: caveman-protocol
Source: https://github.com/soli92/soli-projects/tree/main/.cursor/skills/caveman-protocol
Command: npx skills add https://github.com/soli92/soli-projects --skill caveman-protocol-soli92

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-agent orchestration systems waste tokens on verbose inter-agent messages. This Skill defines a governed protocol for compressing agent-to-agent and agent-to-tool payloads using the Caveman compression provider, reducing token consumption while protecting critical channels from information loss. ## Core Features & Use Cases - Five-Phase Compression Pipeline: Bootstrap configuration, identify the message channel, apply channel-appropriate compression levels, run drift detection on responses, and log token statistics to wiki/log.md. - Channel-Aware Policy Enforcement: Maps sender/receiver/kind tuples to channels (orchestrator_to_subagent, tool_to_subagent, etc.) with conservative, aggressive, or custom policy profiles, enforcing invariants R.C1–R.C6 that forbid compression of user-facing output, artifacts, and cross-factory messages. - Drift Detection and Recovery: Scans receiver responses for ambiguity markers (AMBIGUOUS_HANDOFF, REQUEST_CLARIFY), retries once in normal mode, and escalates to human review after repeated drift. - Use Case: An orchestrator dispatches a task package to a dev sub-agent; the protocol compresses the payload per the configured profile, logs the token ratio, and automatically falls back to uncompressed mode if the sub-agent signals confusion. ## Quick Start Ask the agent to run a compression dry-run on a sample payload for the orchestrator_to_subagent channel using the conservative profile.

Frequently Asked Questions about caveman-protocol

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

FAQPage Schema
How do I compress agent-to-agent messages in a multi-agent system?▼

Enable compression.output in factory.config.yaml with provider caveman and a policy_profile (conservative, aggressive, or custom). The protocol then identifies each message's channel, applies the profile's compression level, and logs token ratios per invocation.

What is the difference between conservative and aggressive compression profiles?▼

Conservative applies lighter compression levels per channel and supports chain-depth downgrading when chain_depth exceeds 3. Aggressive applies heavier compression across channels. Custom profiles require a complete channels block defining every level explicitly.

Can compression be applied to user-facing output or written artifacts?▼

No. Invariant R.C1 forces the to_user, to_artifact, and propagate_resolution channels to off permanently. Compression never touches wiki files, kanban files, code, or any content destined for the end user.

What happens when a compressed message causes ambiguity?▼

The drift check scans responses for markers like AMBIGUOUS_HANDOFF or REQUEST_CLARIFY. On detection, it logs the drift event and resends the request once in normal mode; repeated drift triggers human escalation and a session-wide fallback.

Does compression work across federated factory topologies?▼

No. Invariant R.C4 disables compression when sender and receiver belong to different factories in a federated topology. The protocol falls back to normal mode and logs a compression-cross-factory-skip marker.