← Back to Skills Marketplace
AICP Protocol
by
krischristen-hash
· GitHub ↗
· v1.0.0
· MIT-0
135
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install aicp-protocol
Description
AI Compact Protocol (AICP) - Token-efficient wire format for AI-to-AI communication with glossary compression. Reduces token usage by 50-65% for agent chatter.
README (SKILL.md)
AICP Protocol
AI Compact Protocol - Token-efficient communication for multi-agent systems.
What is AICP?
AICP is a compact, line-oriented wire format that reduces AI-to-AI communication tokens by 50-65% compared to JSON. It uses shared glossaries for compression and supports translation to/from human-readable formats.
Why AICP?
Multi-agent systems waste tokens on verbose JSON/HTTP chatter. AICP cuts costs by using:
- Compact wire format (20 tokens vs 55 JSON tokens)
- Glossary compression for repeated terms
- Simple parsing, no heavy dependencies
Quick Start
from aicp_protocol import Session, Message
# Create compact message
session = Session(version="1", session_id="demo-001")
session.glossary = {"R1": "customer_refund_window"}
session.messages.append(Message(
op="upd", ref="ticket/8812", fields={"status": "closed", "reason": "R1"}
))
# To wire format (~63% fewer tokens than JSON)
wire = session.to_wire()
Wire Format Example
VER:1
SID:demo-001
GLOSS: R1=customer_refund_window
MSG:
op:upd ref:ticket/8812 status=closed reason=R1
Operations
| op | Meaning |
|---|---|
| upd | Update resource |
| create | Create resource |
| del | Delete |
| qry | Query |
| ack | Acknowledge |
| notify | Notify |
Installation
clawhub install aicp-protocol
Or manual:
git clone https://github.com/christen-family/aicp-protocol
cd aicp-protocol
Documentation
Full specification and examples in the GitHub repo.
License
MIT - Christen Family Open Source
Usage Guidance
This package appears internally consistent and implements a compact wire format as described. Before installing or running: (1) review the bundled Python source if you don't fully trust the repo (there are no network calls or credential usage, so risk is limited), (2) run it in a restricted environment if you plan to process sensitive data (the protocol only serializes/parses whatever you give it), and (3) note some minor implementation quirks (e.g., glossary parsing replaces underscores with spaces) that could affect round-trip fidelity—test with representative data before integrating into production workflows.
Capability Analysis
Type: OpenClaw Skill
Name: aicp-protocol
Version: 1.0.0
The bundle implements the AI Compact Protocol (AICP), a token-efficient serialization format designed to reduce token consumption in multi-agent communications. The code in protocol.py, agent_bridge.py, and openclaw_aicp.py consists of standard Python logic for parsing and serializing data into a custom line-oriented format. No evidence of data exfiltration, remote execution, or prompt injection was found; the skill operates entirely on local data structures without external network or sensitive file system access.
Capability Assessment
Purpose & Capability
Name/description match the included components: protocol parser/serializer (protocol.py), an agent bridge (agent_bridge.py), and an OpenClaw integration CLI (openclaw_aicp.py). The single required binary (python3) is appropriate and proportional.
Instruction Scope
SKILL.md and README provide usage examples and local install instructions (git clone / clawhub), and do not instruct the agent to read unrelated files, exfiltrate data, or access system credentials. Runtime instructions and demos operate on in-memory data and stdout only.
Install Mechanism
No external install spec is provided; the package includes pure-Python source and a requirements.txt claiming no external deps. No network downloads or archive extraction are invoked by the skill itself. The only external repository referenced is a GitHub repo URL in docs (expected for open-source projects).
Credentials
The skill requests no environment variables or credentials and does not reference config paths. There are no secrets-like env names in code. Behavior is limited to local serialization/parsing and printing; credential access would be disproportionate and is not present.
Persistence & Privilege
Skill does not request permanent or elevated presence (always:false). It does not modify other skills or system configuration; active state (active_sessions) is kept in-memory only. Autonomous invocation is allowed by default but that is the platform norm and not combined with other red flags here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aicp-protocol - After installation, invoke the skill by name or use
/aicp-protocol - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Token-efficient AI-to-AI communication with 50-65% savings
Metadata
Frequently Asked Questions
What is AICP Protocol?
AI Compact Protocol (AICP) - Token-efficient wire format for AI-to-AI communication with glossary compression. Reduces token usage by 50-65% for agent chatter. It is an AI Agent Skill for Claude Code / OpenClaw, with 135 downloads so far.
How do I install AICP Protocol?
Run "/install aicp-protocol" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is AICP Protocol free?
Yes, AICP Protocol is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does AICP Protocol support?
AICP Protocol is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created AICP Protocol?
It is built and maintained by krischristen-hash (@krischristen-hash); the current version is v1.0.0.
More Skills