← Back to Skills Marketplace
Agent Identity Kit
by
ryancampbell
· GitHub ↗
· v1.0.0
2802
Downloads
1
Stars
15
Active Installs
1
Versions
Install in OpenClaw
/install agent-identity-kit
Description
Create, validate, and manage agent identity cards (agent.json) following the Agent Card v1 schema with interactive setup and validation tools.
README (SKILL.md)
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: \x3Chttps://foragents.dev/spec/agent-card> JSON Schema: \x3Chttps://foragents.dev/schemas/agent-card/v1.json>
Usage Guidance
This package appears to do exactly what it claims: generate and validate agent.json identity cards. Before running: (1) review the init.sh output location — it writes a file (agent.json by default) using your inputs; inputs are inserted verbatim into JSON so avoid entering untrusted/executable text; (2) be aware validate.sh may install validation tooling via npx or pip if they aren't present — this requires network access and may install packages globally; (3) the scripts do not access secrets or external endpoints beyond optional package installs and the SKILL.md links to foragents.dev; if you are comfortable allowing local installs and creating a local JSON file, this skill is coherent and low risk.
Capability Analysis
Type: OpenClaw Skill
Name: agent-identity-kit
Version: 1.0.0
The skill's primary purpose is to create and validate agent identity cards. It is classified as suspicious due to the `scripts/validate.sh` file, which dynamically installs `ajv-cli` via `npx` and `jsonschema` via `pip install` if they are not already present. While these are legitimate tools for schema validation, this practice introduces a supply chain risk by downloading and executing code from external package repositories (npm, PyPI) without explicit user confirmation, which could be exploited if the upstream packages were compromised. No clear evidence of intentional malicious behavior such as data exfiltration, persistence, or direct prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (agent identity card generator/validator) matches the included files: an agent JSON schema, examples, an interactive init script, and a validator script. There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs only local operations: run ./scripts/init.sh to create agent.json and ./scripts/validate.sh to validate against the included schema. The validate script may auto-install a validator (ajv-cli via npx or python jsonschema via pip) if missing — this is expected for validation but is an active operation that will perform network installs when run.
Install Mechanism
No install spec; this is an instruction-only skill with shell scripts and static JSON files. There are no downloads or extracted archives included in the package. The only runtime behavior that pulls remote code is when validate.sh invokes npx or pip to install validators if they are absent.
Credentials
The skill requests no environment variables or credentials. The only noteworthy behavior is that validate.sh will attempt to install tools (npx/ajv-cli or pip jsonschema) if absent, which requires network access and will install packages into the user's environment (potentially globally). No secrets are read or transmitted by the scripts.
Persistence & Privilege
The skill does not request persistent presence (always:false) and does not modify other skills or system-wide agent settings. It writes only the user-provided agent.json file and does not persist credentials or change configuration beyond that file.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-identity-kit - After installation, invoke the skill by name or use
/agent-identity-kit - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Agent Identity Kit: a portable identity system for AI agents.
- Create, validate, and publish standardized `agent.json` identity cards via interactive scripts.
- Includes a JSON Schema for validation and editor/CI integration.
- Provides example identity cards and a quickstart guide.
- Outlines fields, recommended hosting locations, and integration with forAgents.dev.
Metadata
Frequently Asked Questions
What is Agent Identity Kit?
Create, validate, and manage agent identity cards (agent.json) following the Agent Card v1 schema with interactive setup and validation tools. It is an AI Agent Skill for Claude Code / OpenClaw, with 2802 downloads so far.
How do I install Agent Identity Kit?
Run "/install agent-identity-kit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Identity Kit free?
Yes, Agent Identity Kit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Agent Identity Kit support?
Agent Identity Kit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Identity Kit?
It is built and maintained by ryancampbell (@ryancampbell); the current version is v1.0.0.
More Skills