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
