← Back to Coding Agents & IDEs
Coding Agents & IDEs by @ryancampbell

agent-identity-kit

A portable identity system for AI agents

New
Source Code

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