https://github.com/minuetai/agents
The open infrastructure for AI agent discovery and interoperability.
https://github.com/minuetai/agents
agents ai ai-agents autonomous-agent autonomous-agents generative-ai json-schema large-language-models multiagent schema
Last synced: 15 days ago
JSON representation
The open infrastructure for AI agent discovery and interoperability.
- Host: GitHub
- URL: https://github.com/minuetai/agents
- Owner: minuetai
- License: mit
- Created: 2025-07-06T12:01:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-06T22:03:42.000Z (8 months ago)
- Last Synced: 2026-03-05T04:38:33.730Z (4 months ago)
- Topics: agents, ai, ai-agents, autonomous-agent, autonomous-agents, generative-ai, json-schema, large-language-models, multiagent, schema
- Language: Shell
- Homepage: https://minuetai.github.io/agents/
- Size: 1.01 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
# Agent Schema
**Agent Schema** — A vendor-neutral standard for describing AI agents and enabling cross-ecosystem interoperability.
[](./schema.json)
[](./docs/Field-Mapping-Overview-v1.0.md)
[](https://github.com/minuetai/agents/actions)
[](./LICENSE)
[](./docs/mappings/CONTRIBUTING.md)
---
## Overview
The canonical schema for AI agent discovery and interoperability. Enables autonomous agents to publish machine-verifiable definitions with:
* identity & model lineage
* skills and benchmark scores
* cost, latency, and safety grade
* publisher verification & compliance attestations
Standardizes agent representation across marketplaces, platforms, and ecosystems — eliminating bespoke adapters and enabling seamless interoperability.
---
## Schema Quick Reference
The schema is located at [`schema.json`](./schema.json) (JSON Schema Draft-07, validator-ready). See [`examples/`](./examples/) for reference implementations. Each example demonstrates a valid schema instance:
| Example | Use Case |
|---------|----------|
| `example_individual_agent.json` | Solo builder / minimal profile |
| `example_corporate_agent.json` | Corporate agent with publisher & attestations |
| `example_enterprise_v1.0.json` | Full enterprise agent (pricing, workplace tasks) |
| `example_legal_agent.json` | Specialized legal analysis agent |
| `example_multimodal_agent.json` | Vision and document processing |
| `example_research_agent.json` | Scientific research agent with evals |
Browse all examples → [`/examples/`](./examples/)
---
## Validation & Integration
**Quick validation (local):**
```bash
# Install validator (Node.js)
npm install -g ajv-cli ajv-formats
# Validate your agent against schema
ajv validate -c ajv-formats \
-s https://raw.githubusercontent.com/minuetai/agents/main/schema.json \
-d your-agent.json
```
**No CLI?** Paste schema and agent JSON into **** and click **Validate Schema & Data**.
**Schema URLs:**
- **Latest** (canonical, tracks main): `https://raw.githubusercontent.com/minuetai/agents/main/schema.json`
See [CONTRIBUTING.md](./CONTRIBUTING.md) for local validation setup.
---
## Documentation & Mappings
Comprehensive field documentation and ecosystem mappings are available in `/docs/`:
- **[Field Mapping Overview](./docs/Field-Mapping-Overview-v1.0.md)** — How Agent Schema fields map to LangChain, AWS Bedrock, OpenRouter, and other frameworks
- **[Mapping Guidelines](./docs/CONTRIBUTING_MAPPINGS.md)** — Contributing to ecosystem mappings
---
## Field Highlights
| Field | Notes |
|-------|-------|
| `model_lineage.base_model` | Base model identifier, e.g., `"mistral/Mixtral-8x7B-Instruct"` |
| `skills[]` | Free-form capability tags, e.g., `["sql-agent", "xss-scanner"]` |
| `evals[]` | Benchmark results with `name`, numeric `score`, and `date` |
| `publisher.entity_type` | `individual`, `corporation`, `nonprofit`, or `public-sector` |
| `attestations[].type` | Compliance indicators: `soc2`, `iso27001`, `pci-dss`, `insurance` |
Full field documentation is in `schema.json`.
---
## 🌐 Publishing & Discovery (Technical Preview)
Developers can already validate and publish Agent Schema–compliant profiles by including a `schema.json` reference in their repositories.
Validated profiles are automatically indexed by a lightweight crawler and appear in the public technical preview at [minuetai.github.io/agents/](https://minuetai.github.io/agents/).
This end-to-end pipeline — schema validation, ingestion, and indexed visibility — demonstrates the interoperability groundwork already in place.
It is currently operated in a limited, low-visibility mode until broader schema adoption begins.
*Goal:* provide a transparent, standards-based foundation for agent discovery without central control or gatekeeping.
---
## Versioning Policy
- **v1.0** — Enterprise standard (stable)
- Future versions will maintain backward compatibility where possible
- Each version is immutable once tagged; pin exact file paths for production CI/CD pipelines
- Follows Semantic Versioning: Major.Minor.Patch (1.0.0, 1.1.0, 2.0.0)
---
## Governance & Contribution
This is an open standard project. Contributions are welcome!
**Contributing:**
1. Fork → create a feature branch → open a PR
2. Run `ajv validate` to check your changes
3. For new schema fields, include a real-world use case
4. Follow [Conventional Commits](https://www.conventionalcommits.org/) for messages
**Governance:**
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines
- See [GOVERNANCE.md](./GOVERNANCE.md) for decision-making framework
- See [LEGAL.md](./LEGAL.md) for terms and attribution
Thank you for helping build an open, interoperable future for autonomous agents!
---
## Learn More
- **[Explodential.com](https://explodential.com)** — Autonomous agent newsletter & research
- **[Validator](https://jsonschemavalidator.io/)** — Online schema validator
---
Product names such as "GPT-4o" are trademarks of their respective owners and appear here for illustrative purposes only.
© 2025 Minuet Labs LLC. Cialint™ is a trademark of Minuet Labs LLC. See [LEGAL.md](./LEGAL.md) for full terms.