✓ Verified 💻 Development ✓ Enhanced Data

Agent Identity Kit

A portable identity system for AI agents.

Rating: 4.5 (216 reviews)
Downloads: 543 downloads
Version: 1.0.0

Overview

A portable identity system for AI agents.

Complete Documentation

View Source →

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

text

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:

text

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

For multiple agents:

text

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: JSON Schema:

Installation

Terminal bash


openclaw install agent-identity-kit

Copied!

💻Code Examples

./scripts/init.sh

scriptsinitsh.txt

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

scriptsvalidatesh-pathtoagentjson.txt

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

## File Structure

└── README.md

-readmemd.txt

## 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:

example.txt

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