← Back to Skills Marketplace
zeglin

AIEOS (AI Entity Object Specification)

by zeglin · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1734
Downloads
5
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install aieos
Description
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.
README (SKILL.md)

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 \x3Curl_or_path> python3 scripts/aieos_tool.py validate --source \x3Curl_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 \x3Curl_or_path> Use --apply to commit changes: python3 scripts/aieos_tool.py apply --source \x3Curl_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 \x3Coutput_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 \x3Coutput_file.html>

References

  • The official url: "https://aieos.org/schema/v1/aieos.schema.json"
  • For detailed understanding of the schema fields, refer to the online specification.
Usage Guidance
What to consider before installing: - The tool will fetch JSON schemas from arbitrary URLs and write the full persona JSON into your workspace (default: ~/.openclaw/workspace/aieos/entity.json). Only load schemas from sources you trust — remote schemas could contain sensitive personal data or malicious payloads. - The script can generate a 'world-facing' HTML bio. If you apply a schema that includes private information (location, birthdate, photos, etc.), that information could be made public — double-check before using the --apply or generate_bio_page commands. - The included Python script uses urllib.request.urlopen, so it performs network I/O. I was only shown a truncated copy of the script; you should review the full scripts/aieos_tool.py to confirm there are no additional network calls, subprocess.exec usages, telemetry endpoints, or code paths that read other system files or attempt to exfiltrate secrets. - Practical precautions: inspect the full script locally, run it in an isolated environment (container or VM) first, back up your existing SOUL.md / IDENTITY.md before applying changes, and verify the OPENCLAW_WORKSPACE path and file permissions. If you are not comfortable auditing the code yourself, ask the publisher for source verification or avoid using remote schema URLs.
Capability Analysis
Type: OpenClaw Skill Name: aieos Version: 1.0.0 The OpenClaw AgentSkills bundle for AIEOS is classified as benign. The `SKILL.md` provides clear, non-malicious instructions for managing AI persona data. The core script, `scripts/aieos_tool.py`, performs file operations (reading/writing to `OPENCLAW_WORKSPACE/aieos/entity.json`, `IDENTITY.md`, `SOUL.md`) and network operations (`urllib.request.urlopen`) solely for loading schemas from specified URLs or local files. There is no evidence of data exfiltration, malicious execution (e.g., `eval`, `subprocess`), persistence mechanisms, prompt injection attempts against the agent, or obfuscation. All actions are directly aligned with the stated purpose of standardizing and managing AI identity.
Capability Assessment
ℹ Purpose & Capability
The skill's name/description (AIEOS persona standardization) aligns with the functionality described and the included script: loading/validating AIEOS JSON schemas, writing a full persona to workspace, updating SOUL.md and IDENTITY.md, exporting, and generating an 'About me' HTML page. One minor mismatch: the SKILL.md references $OPENCLAW_WORKSPACE but the skill declares no required env vars; the script falls back to a default workspace path. Overall the capabilities requested are broadly proportionate to the stated purpose.
ℹ Instruction Scope
Instructions direct the agent to load schemas from URLs or local files and to write the entire AIEOS JSON into $OPENCLAW_WORKSPACE/aieos/entity.json, plus update SOUL.md and IDENTITY.md and optionally produce a world-facing HTML bio. These actions are within the persona-management scope, but they do involve network fetches of arbitrary URLs and writing potentially sensitive or identifying data to disk (and producing a public HTML page). That introduces an exposure risk if untrusted schemas are used. The SKILL.md does not instruct reading unrelated system files, which is good.
✓ Install Mechanism
No install spec is provided (instruction-only with an included script). This is the lowest-risk install model: nothing is downloaded during install. The included Python script is run locally and relies on standard library modules. No external package fetches are declared.
ℹ Credentials
The skill declares no required environment variables or credentials. The script uses the OPENCLAW_WORKSPACE env var if present, otherwise defaults to ~/.openclaw/workspace. That is reasonable for a workspace-oriented tool, but SKILL.md mentions $OPENCLAW_WORKSPACE without declaring it as a requirement. The script will create/write files under that workspace (including aieos/entity.json), which may contain sensitive personal data — the skill does not request any secrets but does write to user disks.
✓ Persistence & Privilege
always is false and user-invocable is true; the skill does not request forced inclusion or elevated platform privileges. It writes files within the agent/workspace but does not appear (from the visible portion) to modify other skills or global agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aieos
  3. After installation, invoke the skill by name or use /aieos
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
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 entities 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 provide the identity schema for the next generation of digital entities.
Metadata
Slug aieos
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 1734 downloads so far.

How do I install AIEOS (AI Entity Object Specification)?

Run "/install aieos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AIEOS (AI Entity Object Specification) free?

Yes, AIEOS (AI Entity Object Specification) is completely free (open-source). You can download, install and use it at no cost.

Which platforms does AIEOS (AI Entity Object Specification) support?

AIEOS (AI Entity Object Specification) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AIEOS (AI Entity Object Specification)?

It is built and maintained by zeglin (@zeglin); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments