MLSCP Skill
MLSCP (Micro LLM Swarm Communication Protocol) is a token-efficient command language for agent-to-agent communication. This skill lets you parse, validate, and generate MLSCP commands without any LLM overhead.
Why Use MLSCP?
| Natural Language | MLSCP | Savings |
|---|---|---|
| "Please modify the file src/chain_orchestrator.py by adding retry logic at line 47" | F+ s/co > ln47 + 'retry logic' | ~75% |
| "Read the contents of utils/file_manager.py from lines 10 to 50" | F? u/fm > ln10-50 | ~80% |
| "Delete the variable 'temp_cache' from config.py" | V- c/c > 'temp_cache' | ~70% |
Quick Start
Parse a Command
./scripts/mlscp.sh parse "F+ s/co > ln47 + 'retry logic'"
Validate Syntax
./scripts/mlscp.sh validate "F+ s/co > ln47 + 'retry logic'"
Generate Vocabulary
./scripts/mlscp.sh vocab /path/to/project
Compress Natural Language
./scripts/mlscp.sh compress "Add error handling to the main function in app.py"
Command Reference
Operations
| Code | Meaning | Example |
|---|---|---|
F+ | File add/insert | F+ s/app > ln10 + 'new code' |
F~ | File modify | F~ s/app > ln10-20 ~ 'updated code' |
F- | File delete | F- s/app > ln10-15 |
F? | File query/read | F? s/app > ln1-100 |
V+ | Variable add | V+ s/app + 'new_var = 42' |
V~ | Variable modify | V~ s/app > 'old_var' ~ 'new_value' |
V- | Variable delete | V- s/app > 'temp_var' |
V? | Variable query | V? s/app > 'config_*' |
Location Specifiers
ln47- Single lineln10-50- Line rangefn:main- Function namecls:MyClass- Class name
Context Blocks
CTX{"intent":"resilience","priority":"high","confidence":0.9}
Scripts
mlscp.sh- Main CLI toolvocab.py- Vocabulary generator (Python)
Integration
With Other Agents
When receiving commands from MLSCP-enabled agents:
./scripts/mlscp.sh parse "$INCOMING_COMMAND"
Sending Commands
Generate compact commands for other agents:
./scripts/mlscp.sh compress "Your natural language instruction"
API (Python)
from mlscp import parse, MLSCPParser
# Quick parse
cmd = parse("F+ s/co > ln47 + 'retry logic'")
print(cmd.operation) # OperationType.FILE_ADD
print(cmd.target) # "s/co"
# With vocabulary
parser = MLSCPParser(vocab_lookup)
cmd = parser.parse("F+ s/co > ln47 + 'code'")
full_path = vocab_lookup.get("s/co") # "src/chain_orchestrator.py"
Resources
- GitHub: https://github.com/sirkrouph-dev/mlcp
- Grammar Spec: See
references/grammar.abnf - Protocol Definition: See
references/protocol.md