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

bash

./scripts/init.sh

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

Validate an existing agent.json

bash

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

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

File Structure

code

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:

code

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

For multiple agents:

code

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