Skip to content

AgentDef

AgentDef — define once, import anything, adapt everywhere

AgentDef is an open specification for defining AI agents in a framework-independent, human-readable format. One canonical definition — plain markdown and YAML, made to live in git — with importers in from 9 formats and adapters out to 8 platforms, deterministic and validated against 500+ real community agents.

pip install agentdef
agentdef import claude CLAUDE.md --output ./my-agent   # bring an existing agent
agentdef validate ./my-agent                            # check conformance
agentdef adapt copilot ./my-agent                       # generate for another platform

Why AgentDef

  • Bidirectional

    Most spec projects only go spec→runtime. AgentDef puts equal weight on importers: your existing CLAUDE.md, Copilot, Cursor, or CrewAI definitions convert automatically, with an item-by-item IMPORT_REPORT.md — nothing dropped silently.

  • Verified, not vibes

    505 real community agents imported with zero failures. Round-trips reach a byte-identical fixed point, tested in CI. A public conformance corpus lets third parties check any validator.

  • Human-readable

    An agent is a directory: agent.md (identity), manifest.yaml (composition), instructions/ (behavior). Product managers can read and edit it; git can diff it.

  • One source of truth

    Declare targets in a sync: block and agentdef sync regenerates every framework file; --check fails CI when they drift.

Explore