Support Agent Skills and Agent Plugins as ORD capability types - #102
Open
Fannon wants to merge 17 commits into
Open
Support Agent Skills and Agent Plugins as ORD capability types#102Fannon wants to merge 17 commits into
Fannon wants to merge 17 commits into
Conversation
|
Fannon
marked this pull request as ready for review
March 30, 2026 08:10
Fannon
changed the title
Fannon
commented
Mar 30, 2026
Fannon
left a comment
Fannon
left a comment
Member
Author
There was a problem hiding this comment.
Alternative: Don't make it a Spec ID, make it a non-prefixed string (as other ORD standardized types are)
Fannon
changed the title
Co-authored-by: Vyshnavi Gadamsetti <74303972+vyshnavigadamsetti@users.noreply.github.com>
| x-introduced-in-version: "1.14.3" | ||
| description: |- | ||
| A ZIP archive containing the definition of an agent skill, including all relevant | ||
| assets such as configuration and schema files. |
There was a problem hiding this comment.
should there be a reference to agentskills.io as the format spec ?
|
If the agent-skill format evolves where is the format version tracked? |
swennemers
reviewed
Jun 2, 2026
swennemers
reviewed
Jun 2, 2026
Fannon
commented
Jun 4, 2026
Co-authored-by: Vyshnavi Gadamsetti <74303972+vyshnavigadamsetti@users.noreply.github.com> Co-authored-by: Simon Heimler <heimlersimon@gmail.com>
Fannon
changed the title
Add an `agent-plugin` capability type that bundles multiple agent resources (such as one or more agent skills) into a single package, with an `agent-plugin-zip` definition type. The bundle is a vendor-neutral ZIP: ORD does not prescribe its internal layout, since no cross-vendor plugin-bundle standard exists yet. Soften `mediaType` to SHOULD (from MUST) on both `agent-skill-zip` and `agent-plugin-zip`, and drop the reverse 'capability SHOULD use <x>-zip' hint to avoid false warnings across opinionated formats. Add a `subset` (with `skillName`) to CapabilityIntegrationAspect so a dependency on a bundling capability like `agent-plugin` can be narrowed to specific contained skills, loading only the minimal surface into the harness / context.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Added
agent-skillfor describing discrete, reusable agent skills that can be invoked by orchestrator agents or other systems.agent-skill-zipfor ZIP archive definitions of agent skills (mediaTypeapplication/zip).agent-pluginfor bundling multiple agent resources (such as one or more agent skills) into a single, distributable package.agent-plugin-zipfor ZIP archive definitions of agent plugins (mediaTypeapplication/zip).integrationDependenciesproperty toCapability, mirroring the property onAgentand analogous toinputPortson Data Products. Lets a capability (notablyagent-skilloragent-plugin) declare the APIs, MCP tools, agents, or other skills it requires to function. See AI Agents and Protocols → Skill Dependencies.subsetproperty toCapabilityIntegrationAspect(newCapabilityIntegrationAspectSubsetobject withskillName). Lets a dependency on a bundling capability such asagent-pluginbe narrowed to specific contained skills, so consumers load only the minimal surface into the harness / context instead of the whole bundle.Changed
ordis a reserved vendor namespace owned by the ORD specification itself, used to register well-known, cross-vendor Specification IDs.Notes
agent-plugin-zipdeliberately references no external packaging standard: research confirmed there is no vendor-neutral bundle standard at the plugin level (skills have Agent Skills, tool servers have MCP/MCPB/OCI, but the full plugin bundle remains vendor-specific, e.g. Claude Code'splugin.json). ORD therefore does not prescribe the archive's internal layout.mediaTypeon the-zipdefinition types isSHOULD(notMUST)application/zip, to avoid brittle validation across opinionated plugin formats.