agent-identity-kitCreate, validate, and manage agent identity cards (agent.json) following the Agent Card v1 schema with interactive setup and validation tools.
Install via ClawdBot CLI:
clawdbot install ryancampbell/agent-identity-kitA portable identity system for AI agents. Create, validate, and publish agent.json identity cards.
agent.json) via interactive setup./scripts/init.shPrompts you for name, handle, description, owner, and capabilities. Outputs a valid agent.json.
./scripts/validate.sh path/to/agent.jsonValidates the file against schema/agent.schema.json. Requires ajv-cli (auto-installs if missing).
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| 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 |
Serve your agent.json at a well-known URL:
https://yourdomain.com/.well-known/agent.jsonFor multiple agents:
https://yourdomain.com/.well-known/agents.jsonRegister your agent at foragents.dev to be indexed in the global agent directory. Verified agents get a badge on their card.
Full specification:
JSON Schema:
Generated Mar 1, 2026
Development teams building AI agents for enterprise or consumer applications use this skill to standardize identity creation across projects. It ensures all agents have consistent, validated identity cards that meet industry specifications, facilitating integration with platforms like forAgents.dev and improving interoperability in multi-agent systems.
Open source communities adopt this skill to provide contributors with a tool for generating and validating agent identity cards. This helps maintain quality control in distributed projects by ensuring all agents adhere to the same schema, reducing errors and enhancing collaboration across different development environments.
Large organizations deploying AI agents for internal automation or customer service use this skill to create and validate identity cards for compliance and security. It enables seamless integration with existing CI/CD pipelines through schema validation, ensuring agents meet corporate standards and can be registered in internal directories.
Platforms that host or sell AI agents utilize this skill to verify agent identities before listing. By validating agent.json files against the schema, they ensure all listed agents have complete and accurate information, improving trust and discoverability for end-users browsing the marketplace.
Universities and research labs developing experimental AI agents use this skill to standardize identity documentation across studies. It aids in reproducibility and sharing by providing a consistent format for agent capabilities and ownership, facilitating collaboration and publication in academic settings.
Offer the core skill for free to attract users, with premium features such as advanced validation reports, custom schema extensions, or integration with proprietary platforms. Revenue is generated through subscription plans for enterprises or individual developers seeking enhanced functionality and support.
Provide paid consulting services to help organizations implement the skill into their workflows, customize schemas, or integrate with existing systems. Revenue comes from project-based fees or retainer contracts, targeting businesses that need tailored solutions for agent identity management.
Operate a marketplace or directory like forAgents.dev, using the skill to validate agent identities for listing. Revenue is generated through listing fees, premium placements, or advertising from agent developers and users seeking visibility in a curated ecosystem.
š¬ Integration Tip
Integrate the validation script into CI/CD pipelines using tools like GitHub Actions to automatically check agent.json files during builds, ensuring compliance with the schema before deployment.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection