AgentDef - define once, import anything, adapt everywhere: nine import formats converge into one canonical agent directory and adapt out to eight platforms

Every AI platform invents its own way to define agents - CLAUDE.md, AGENTS.md, cursor-rules.md, copilot-instructions.md, declarative manifests... The concepts are always the same; only the files differ. AgentDef is an open specification that captures what an agent IS - identity, instructions, skills, workflows, tools - in one canonical, human-readable directory. Adapters generate the file each platform wants; importers convert your existing files back into the canonical form (505 real community agents imported with zero failures).

Quick Start

An AgentDef agent is just a directory. The spec defines canonical components - agent.md (identity), manifest.yaml (composition), instructions/, and optionally skills/, workflows/, tools/, knowledge/, memory/, runtime/, evals/ - everything is plain markdown and YAML, made to live in git.

The smallest valid agent:

my-agent/
├── agent.md          # Who is this agent?
├── manifest.yaml     # What does it use?
└── instructions/
    └── core.md       # How does it behave?

Copy the starter template and fill in your content - or let agentdef init do it for you:

CLI

Install AgentDef:

pip install agentdef

8 adapters (Claude, OpenAI AGENTS.md, Cursor, GitHub Copilot, LangGraph, M365 Copilot, OpenAI Assistants, CrewAI). 9 importers (those plus Copilot Studio, Letta .af, and any markdown prompt file).

agentdef init my-agent --yes                 # scaffold a valid agent
agentdef validate ./my-agent/
agentdef adapt claude ./my-agent/ --output CLAUDE.md
agentdef import copilotstudio agent-doc.md --output ./my-agent/
agentdef sync ./my-agent/                    # regenerate all configured framework files
agentdef list                                # every adapter/importer framework

Every import writes an IMPORT_REPORT.md: what mapped, what was inferred, what was dropped - nothing is dropped silently.

Take the tour

Explore this repo's own architecture as an interactive knowledge graph, with a guided 10-step walkthrough of the codebase:

AgentDef architecture dashboard - interactive knowledge graph with a guided project tour

▶ Open the live dashboard - generated from the code itself with the understand-anything plugin, so it can't silently go stale.

Documentation

Full docs: https://agentdef.github.io/agentdef/

Status

Spec 0.5.0 - tooling 0.2.0 - see STATUS and the ROADMAP. The format is stable enough for experimentation and feedback; breaking changes are possible before 1.0.

Contributing

See CONTRIBUTING.md. Want a framework we don't cover? Open a framework request.

License

Apache 2.0 - see LICENSE.

Project links

Data verified by PyPI on Jul 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for humbertcostas from gravatar.com humbertcostas

Credits

Author: AgentDef contributors

GitHub Statistics

Data verified by PyPI on Jul 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache License)

Requires

Python >=3.10

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentdef-0.2.0.tar.gz (54.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentdef-0.2.0-py3-none-any.whl (65.0 kB view details)

Uploaded Python 3

File details

Details for the file agentdef-0.2.0.tar.gz.

File metadata

  • Download URL: agentdef-0.2.0.tar.gz
  • Upload date:
  • Size: 54.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentdef-0.2.0.tar.gz
Algorithm Hash digest
SHA256 1e37416fbe9b81e54af0dc193b5194a10d6f02cc108badcb8fd354cc74bae669
MD5 7a694d95f1355ce9c896ae89c5cb419b
BLAKE2b-256 7e60bcba8dc751293ea86b7be000b1e1b17883101109d42d8fc63985371ab215

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentdef-0.2.0.tar.gz:

Publisher: release.yml on agentdef/agentdef

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentdef-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: agentdef-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 65.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentdef-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3e8280abad12f52e3c814cccc179462cf0e76931db45185c459c6a05b91efc6b
MD5 345888499c88eee4be8bdad9156cce08
BLAKE2b-256 a2bec2b4b3ff72f29a564bb26fed8467cb4e85b355c2e929c90a0f57d8098ecc

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentdef-0.2.0-py3-none-any.whl:

Publisher: release.yml on agentdef/agentdef

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page