Azure / Azure/git-ape

Adopt Agent Plugins 1.0

Open
#294 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
269
Forks
45
Avg merge
18h 41m
Merged PRs (30d)
11

Description

## Adopt Agent Plugins 1.0

### Why this matters

Agent Plugins 1.0 is an open, vendor-neutral standard for packaging reusable Agent Skills and MCP servers so they can be discovered and loaded consistently across compatible clients.

Adopting the standard would make this plugin easier to consume across GitHub Copilot, Codex, Cursor, VS Code, and other compatible clients without requiring client-specific repackaging or duplicated component structures.

Resources:

- [Agent Plugins](https://agent-plugins.org/)
- [Agent Plugins 1.0 specification](https://agent-plugins.org/specification)
- [GitHub Changelog: Agent Plugins 1.0 in VS Code, Copilot CLI, and the Copilot app](https://github.blog/changelog/2026-08-12-agent-plugins-1-0-in-vs-code-copilot-cli-and-the-copilot-app/)

### Requested changes

Please update this plugin to conform to the Agent Plugins 1.0 specification:

- Move `plugin.json` to the root of the plugin directory.
- Add the `$schema` field:

````json
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json"
}
````

- Align the manifest fields with the Agent Plugins 1.0 schema.
- Place portable Agent Skills under the plugin-root `skills/` directory.
- Place MCP server configuration in the plugin-root `mcp.json` file, where applicable.
- Use the `com.github.copilot/` namespace for GitHub Copilot-specific components and metadata that are outside the portable Agent Plugins contract, such as agents, hooks, instructions, and extensions (including canvases).

The intended structure is similar to:

````text
plugin/
├── plugin.json
├── skills/
│ └── /
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
└──
````

### Compatibility considerations

If this repository also supports Claude Code's plugin format, please retain the Claude-specific manifest and layout as needed. Claude Code does not currently support the Agent Plugins 1.0 specification, so `.claude/plugin.json` may still be required for Claude Code compatibility.

However, the portable Agent Plugins manifest should live at the plugin root, and portable components should follow the standard locations described in the specification.

If the current plugin uses a non-standard location for any of the following, please consider moving or exposing them through the standard layout:

- Skills should be discoverable under the plugin-root `skills/` directory.
- MCP configuration should be available through the plugin-root `mcp.json` file.
- Client-specific files should be placed under the appropriate reverse-domain namespace, such as `com.github.copilot/`.

This would allow the plugin to support multiple clients while preserving any existing client-specific integrations.

Contributor guide

Open the contributing guide

Research direction

Inspect the current plugin layout and compare it with the Agent Plugins 1.0 specification. Check how plugin.json, .claude/plugin.json, skills/, mcp.json, and client-specific components are currently organized, then preserve Claude Code compatibility while adding the requested root manifest and namespaced layout. Done means the portable structure and manifest conform to the specification without losing existing integrations.

Written by the indexing model from the issue text.

Assessment

Domain
tooling
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.