Agent Identity Kit

Create, validate, and manage agent identity cards (agent.json) following the Agent Card v1 schema with interactive setup and validation tools.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install agent-identity-kit

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