Agent Identity Kit
Skill by ryancampbell
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ryancampbell/agent-identity-kitAgent 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
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ryancampbell-agent-identity-kit": {
"enabled": true,
"auto_update": true
}
}
}