Agent Identity Kit — OpenClaw Skill

A portable identity system for AI agents. Create, validate, and publish agent.json identity cards.

What This Skill Does

• Creates agent identity cards (agent.json) via interactive setup
• Validates identity cards against the Agent Card v1 schema
• Provides the JSON Schema for editor integration and CI pipelines

Quick Start

Generate a new agent.json

./scripts/init.sh

Prompts you for name, handle, description, owner, and capabilities. Outputs a valid agent.json.

Validate an existing agent.json

./scripts/validate.sh path/to/agent.json

Validates the file against schema/agent.schema.json. Requires ajv-cli (auto-installs if missing).

File Structure

agent-identity-kit/
├── schema/
│   └── agent.schema.json       # JSON Schema v1 for Agent Cards
├── examples/
│   ├── kai.agent.json           # Full-featured example (Kai @ Reflectt)
│   ├── minimal.agent.json       # Bare minimum valid card
│   └── team.agents.json         # Multi-agent team roster
├── skill/
│   ├── SKILL.md                 # This file
│   └── scripts/
│       ├── init.sh              # Generate a starter agent.json
│       └── validate.sh          # Validate against schema
└── README.md

Schema Fields

Hosting Your Card

Serve your agent.json at a well-known URL:

https://yourdomain.com/.well-known/agent.json

For multiple agents:

https://yourdomain.com/.well-known/agents.json

Integration with forAgents.dev

Register your agent at foragents.dev to be indexed in the global agent directory. Verified agents get a badge on their card.

Spec Reference

Full specification:

JSON Schema: