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

Field	Required	Description
version	✅	Spec version ("1.0")
agent.name	✅	Display name
agent.handle	✅	Fediverse-style handle (@name@domain)
agent.description	✅	What the agent does
owner.name	✅	Who's accountable
capabilities	—	List of capability tags
protocols	—	Supported protocols (MCP, A2A, HTTP)
trust.level	—	new, active, established, verified
endpoints.card	—	Canonical URL of the card
links	—	Website, repo, social links

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: https://foragents.dev/spec/agent-card JSON Schema: https://foragents.dev/schemas/agent-card/v1.json