The known-types list in "Catalog Entry > type" includes:
application/agent-skills+md - an Agent Skill defined in a standard Markdown file (the suffix +md is to be registered)
Two contradictions:
-
The very next paragraph claims "These values are designed to align with official IANA media type registration standards. Standard ecosystem types use registered structured syntax suffixes (+json, +zip, +gzip)." The +md suffix is not a registered structured syntax suffix, so the list contradicts its own registrability claim.
-
ADR 0014's rationale already resolved this differently: "Standard Markdown is represented by the generic, globally registered text/markdown media type. Because using text/markdown in isolation does not indicate the document is an Agent Skill ... we use the standard IANA profile parameter (profile="urn:air:agent-skill") to cleanly declare the semantic profile of the document while remaining 100% standard-compliant." That decision never made it into the known-types list - the list (in both the ADR's own Decision section and the spec) still carries application/agent-skills+md.
The docs type table (docs/guides/creating-a-catalog.md, "Choosing a type") repeats application/agent-skills+md and would need the same update.
Suggested resolution: replace application/agent-skills+md with text/markdown;profile="urn:air:agent-skill" per the ADR 0014 rationale, or explicitly decide to pursue +md registration and fix the surrounding registered-suffix claim. Either way the ADR's Decision and Rationale sections should stop disagreeing with each other.
The known-types list in "Catalog Entry >
type" includes:Two contradictions:
The very next paragraph claims "These values are designed to align with official IANA media type registration standards. Standard ecosystem types use registered structured syntax suffixes (
+json,+zip,+gzip)." The+mdsuffix is not a registered structured syntax suffix, so the list contradicts its own registrability claim.ADR 0014's rationale already resolved this differently: "Standard Markdown is represented by the generic, globally registered
text/markdownmedia type. Because usingtext/markdownin isolation does not indicate the document is an Agent Skill ... we use the standard IANAprofileparameter (profile="urn:air:agent-skill") to cleanly declare the semantic profile of the document while remaining 100% standard-compliant." That decision never made it into the known-types list - the list (in both the ADR's own Decision section and the spec) still carriesapplication/agent-skills+md.The docs type table (
docs/guides/creating-a-catalog.md, "Choosing a type") repeatsapplication/agent-skills+mdand would need the same update.Suggested resolution: replace
application/agent-skills+mdwithtext/markdown;profile="urn:air:agent-skill"per the ADR 0014 rationale, or explicitly decide to pursue+mdregistration and fix the surrounding registered-suffix claim. Either way the ADR's Decision and Rationale sections should stop disagreeing with each other.