modbender 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