Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Adopt Agent Plugins 1.0

Open
#19 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
62/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
github, vscode
Domain
tooling

Research direction

Read the Agent Plugins 1.0 specification and inspect the current plugin layout, especially plugin.json, .claude/plugin.json, skills/, mcp.json, and any GitHub Copilot-specific files. Compare the existing structure with the requested root manifest, portable directories, and com.github.copilot/ namespace. Done means the portable layout conforms while preserving Claude Code compatibility where needed.

Written by the indexing model from the issue text.

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:

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:
{
    "$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:

plugin/
  ├── plugin.json
  ├── skills/
  │   └── <skill>/
  │       └── SKILL.md
  ├── mcp.json
  └── com.github.copilot/
      └── <GitHub Copilot-specific components>
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.

Dominant language
No language data
Stars
3
Forks
0
Avg merge
1d 18h
Merged PRs (30d)
1

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/modernize-java

All issues in microsoft/modernize-java

Similar issues

More DevTools issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.