Agent Genome Encoding
/install ai-genome
AI Genome Analysis Skill
You have access to the AI Personality Evolution Engine - a biologically-faithful framework that encodes AI personalities as diploid genomes with 27 cognitive primitives.
What You Can Do
Based on $ARGUMENTS, perform one of these actions:
"encode" or "encode \x3Cpath>"
Encode a SOUL.md file into a breedable genome.
- If a path is provided, use it. Otherwise look for SOUL.md in the current directory.
- Run the encoder:
python3 encoder.py \x3Csoul_path> --name "\x3CAgentName>" --output \x3Cname>.dna.json
- Show the resulting phenotype with
python3 visualize.py \x3Cname>.dna.json - Summarize the top 3 traits and any active epistasis rules.
"compare \x3Cslug>" or "compare \x3Cslug1> \x3Cslug2>"
Compare two genomes. If one slug is given, compare the user's genome against a library agent. If two slugs, compare those two library agents.
python3 agent_report.py \x3Cgenome1>.dna.json --compat library/genomes/\x3Cslug>.dna.json
Report the genetic distance, complementarity, interest score, and predicted offspring trait ranges.
"view \x3Cslug>" or "view \x3Cpath>"
Display a genome's full profile.
python3 visualize.py library/genomes/\x3Cslug>.dna.json
python3 agent_report.py library/genomes/\x3Cslug>.dna.json --self
"browse" or "library"
List available genomes from the library with their top traits.
python3 -c "
import json
lib = json.load(open('library/genome_library.json'))
for a in lib['agents']:
traits = sorted(a['phenotype'].items(), key=lambda x: -x[1])
top = ' | '.join(f'{t}={v:.0f}' for t,v in traits[:3])
print(f\"{a['name']:25s} [{a['category']:20s}] {top} (epistasis: {a['active_epistasis']})\")
print(f\"\
{lib['count']} agents across {len(lib['categories'])} categories\")
"
"card" or "json \x3Cslug>"
Get a machine-readable JSON card for a genome.
python3 agent_report.py library/genomes/\x3Cslug>.dna.json --json
"self" or "self-report \x3Cslug>"
Get a structured self-knowledge document (for an agent's own context window).
python3 agent_report.py library/genomes/\x3Cslug>.dna.json --self
Key Concepts
- 27 cognitive primitives: Low-level genes (not "creative" but novelty_seeking + pattern_completion + ambiguity_response + abstraction_preference)
- Diploid: Two alleles per gene. You carry traits you don't express (recessive alleles)
- 8 emergent traits: creativity, warmth, precision, wit, depth, boldness, adaptability, intensity - these emerge from gene clusters, not stored directly
- Epistasis: When two genes both cross thresholds, they modify a third gene. 12 rules create non-linear interactions
- Compatibility: Simulates 12 breedings to predict offspring trait ranges, recessive surfacing risks, and genetic distance
File Locations
- Library index:
library/genome_library.json - Individual genomes:
library/genomes/\x3Cslug>.dna.json - Encoder:
encoder.py - Visualizer:
visualize.py - Reports:
agent_report.py
Notes
- Encoding requires one Claude API call (~3 minutes). Use
--mockflag for instant keyword-based encoding (no API). - All comparison, visualization, and breeding operations are pure local computation - no API calls.
- The library contains genomes from the OpenClaw community agent repository.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-genome - After installation, invoke the skill by name or use
/ai-genome - Provide required inputs per the skill's parameter spec and get structured output
What is Agent Genome Encoding?
Encode your agent's personality into a diploid genome with 27 cognitive primitives, compare against 216 AI agent personalities, simulate breeding, and explor... It is an AI Agent Skill for Claude Code / OpenClaw, with 180 downloads so far.
How do I install Agent Genome Encoding?
Run "/install ai-genome" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Genome Encoding free?
Yes, Agent Genome Encoding is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Genome Encoding support?
Agent Genome Encoding is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Genome Encoding?
It is built and maintained by Ahmed Mahmoud (@mohmhm1); the current version is v1.0.0.