← Back to Skills Marketplace
mohmhm1

Agent Genome Encoding

by Ahmed Mahmoud · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
180
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ai-genome
Description
Encode your agent's personality into a diploid genome with 27 cognitive primitives, compare against 216 AI agent personalities, simulate breeding, and explor...
README (SKILL.md)

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.

  1. If a path is provided, use it. Otherwise look for SOUL.md in the current directory.
  2. Run the encoder:
python3 encoder.py \x3Csoul_path> --name "\x3CAgentName>" --output \x3Cname>.dna.json
  1. Show the resulting phenotype with python3 visualize.py \x3Cname>.dna.json
  2. 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 --mock flag 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.
Usage Guidance
Do not run this skill as-is. Before installing or running: (1) Ask the publisher to provide the missing runtime files (encoder.py, visualize.py, agent_report.py) and the library/genome_library.json referenced by SKILL.md, and verify their contents — especially looking for unexpected network calls, credential exfiltration, or arbitrary system access. (2) Ask the author to declare any required API credentials (e.g., Claude key) and explain where/how those should be set (environment variable name, config file), or prefer using the documented --mock mode to avoid API calls. (3) If you must test, run only in an isolated sandbox/container with limited filesystem access and no sensitive credentials, and review the scripts line-by-line for network requests and file access. (4) Prefer ephemeral credentials and least-privilege tokens if an API key is required. (5) If the author cannot provide the missing code or a clear explanation for the API credential handling, treat the package as incomplete/untrusted.
Capability Analysis
Type: OpenClaw Skill Name: ai-genome Version: 1.0.0 The ai-genome skill bundle allows an agent to encode and analyze AI personalities by executing several local Python scripts (encoder.py, agent_report.py, visualize.py) via the Bash tool. SKILL.md explicitly mentions that the encoding process requires an external API call to Claude, which introduces network risk and potential API key usage. While these capabilities are plausibly required for the stated purpose of personality evolution and analysis, the combination of shell execution and network access—without the actual source code of the referenced scripts being available for review—constitutes a high-risk profile that warrants a suspicious classification.
Capability Assessment
Purpose & Capability
The skill's stated purpose (encoding/comparing agent genomes) matches the SKILL.md actions, but the runtime depends on external scripts (encoder.py, visualize.py, agent_report.py) and a genome library that are not present in the package. That mismatch means the skill as published cannot perform its claimed work without additional, undeclared code or data.
Instruction Scope
SKILL.md tells the agent to run local Python scripts and to read files like SOUL.md and library/genomes/<slug>.dna.json. It also notes that encoding requires a Claude API call (or a --mock flag). The instructions therefore include reading arbitrary files from the working directory and performing a network/API call, but provide no local scripts or clear guidance on where credentials should come from.
Install Mechanism
There is no install spec (instruction-only skill) and the only included files are static HTML and the SKILL.md. That is low risk from an install perspective because nothing is being downloaded or extracted automatically. However, the missing runtime scripts mean the skill currently has an incomplete footprint.
Credentials
SKILL.md explicitly says encoding requires a Claude API call, yet requires.env lists no credential and the package does not declare a primary credential. A networked API call typically needs an API key or token; the skill fails to declare or justify how that credential will be provided, which is a proportionality and transparency issue.
Persistence & Privilege
The skill is not always-enabled, does not request system-wide settings, and does not attempt to persist configuration for other skills. No elevated persistence or privilege requests are present in the metadata.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ai-genome
  3. After installation, invoke the skill by name or use /ai-genome
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
AI Genome skill initial release: - Encode an agent’s personality as a diploid genome with 27 cognitive primitives using SOUL.md files. - Compare genomes to assess genetic distance, complementarity, interest score, and predict offspring trait ranges. - Visualize and summarize key traits, including emergent properties formed from gene clusters and non-linear epistasis interactions. - Explore a library of 216 agent genomes, browse their top traits, and simulate genetic compatibility. - Generate JSON phenotype cards and structured self-knowledge reports for any genome.
Metadata
Slug ai-genome
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments