Specification Documents

This directory holds the draft (v0.1.0) specification of each registry entry type: the fields it MUST, SHOULD, or MAY carry, its relationship to any upstream standard it profiles, its validation rules, and a worked example. Every specification here is a prose statement of what a schemas/*.v1.schema.json file already enforces mechanically; none of them defines a field the corresponding schema does not already have. See theSchema reference for the schemas themselves.

Common Entry Core Specification
This document specifies the normative structure of the fields every registry entry carries, regardless of its type.
Model Entry Specification
This document specifies the normative structure of a model entry in the GA4GH AI Registry.
Agent Entry Specification
This document specifies the normative structure of an agent entry in the GA4GH AI Registry: which fields it MUST, SHOULD, or MAY carry, how those fields relate to the agent's own live agent-info endpoint, and what a validator or maintainer reviewer checks beyond the JSON Schema itself.
Skill Entry Specification
This document specifies the normative structure of a skill entry in the GA4GH AI Registry: which fields it MUST, SHOULD, or MAY carry, how it embeds a SKILL.md-style description, and what a validator or maintainer reviewer checks beyond the JSON Schema itself.
MCP Server Entry Specification
This document specifies the normative structure of an MCP server entry in the GA4GH AI Registry: how it embeds a verbatim, valid server.json document, where GA4GH-specific metadata is allowed to live inside that document, and what a validator or maintainer reviewer checks beyond the JSON Schema itself.
Plugin Entry Specification
This document specifies the normative structure of a coding-harness plugin entry in the GA4GH AI Registry: how it embeds a verbatim Claude Code plugin.json document, how the ga4gh sibling object records which coding harnesses the plugin targets and how to install it for each, and what a validator or maintainer reviewer checks beyond the JSON Schema itself.
Bundle Entry Specification
This document specifies the normative structure of a bundle entry in the GA4GH AI Registry: how it embeds a verbatim Claude Code marketplace.json document, how the ga4gh sibling object records provenance and cross-references, and what a validator or maintainer reviewer checks beyond the JSON Schema itself.