AIEOS (AI Entity Object Specification)

AIEOS (AI Entity Object Specification) is a standardization framework designed to solve the "identity crisis" currently facing AI agents. Combined with Soul Documents, together the…

zeglin

@zeglin

What This Skill Does

Standardization framework that defines a portable, structured blueprint for AI agent personality, behavior, and memory. It loads, validates, applies, and exports AIEOS schemas to ensure consistent agent identity across different models and ecosystems.

Replaces fragile, model-specific prompt engineering by treating agent personality as a deployable, standardized asset that remains intact across platforms.

When to Use It

  • Load and validate an AIEOS schema from a URL or local file
  • Apply a standardized persona blueprint to an agent's identity files
  • Export an agent's current persona as a complete AIEOS schema
  • Generate an HTML bio page from an agent's AIEOS persona data
  • Migrate an agent's behavioral traits between different AI models or platforms

Install

$ openclaw skills install @zeglin/aieos

AIEOS (AI Entity Object Specification)

Overview

AIEOS (AI Entity Object Specification) is a standardization framework designed to solve the "identity crisis" currently facing AI agents. Combined with Soul Documents, together they form a comprehensive blueprint for AI behavior.

The goal is to establish a standardized data structure that defines exactly how an agent speaks, reacts, and remembers. This allows developers, and agents themselves, to construct specific personas with the portability to move across different ecosystems without losing their behavioral integrity.

As we move toward a world of "Agentic Workflows," AIEOS ensures that agents maintain consistent traits regardless of the underlying model. By treating personality as a deployable asset rather than a fragile prompt, we are providing the "DNA kit" for the next generation of digital entities.

Usage

This skill provides commands to manage your identity using the AIEOS standard:

  • Comprehensive Identity Integration: When applying an AIEOS schema, the skill now stores the entire, detailed AIEOS JSON blueprint in $OPENCLAW_WORKSPACE/aieos/entity.json. This ensures that all parameters, types, and intricate details of your persona are preserved and constantly accessible to the agent. IDENTITY.md and SOUL.md are then enriched with human-readable summaries derived from this comprehensive data.

  • Load & Validate Schema: Load an AIEOS schema from a URL or local file and validate its structure. python3 scripts/aieos_tool.py load --source <url_or_path> python3 scripts/aieos_tool.py validate --source <url_or_path>

  • Apply Schema to Identity: Apply an AIEOS schema to update your comprehensive persona data (entity.json), as well as your IDENTITY.md and SOUL.md files. This performs a dry run by default, showing proposed changes. python3 scripts/aieos_tool.py apply --source <url_or_path> Use --apply to commit changes: python3 scripts/aieos_tool.py apply --source <url_or_path> --apply

  • Export Current Identity: Convert your current detailed persona (from entity.json) into a complete AIEOS schema and export it to a JSON file. python3 scripts/aieos_tool.py export --output <output_file.json>

  • Generate "About Me" Page: Creates a world-facing HTML bio page based on your comprehensive AIEOS persona data and associated image URLs (if available in the schema). Requires an output file path. python3 scripts/aieos_tool.py generate_bio_page --output <output_file.html>

References

Top skills in this category