agent/skills/ folder.
Choose a host
Claude Code
Generate the Claude package and load it locally.
ChatGPT
Connect your server and prepare a plugin for ChatGPT.
Codex
Package your tools and workflow skills for Codex.
Other Agent Plugins hosts
Use the portable format in a compatible host.
Before you start
You need an MCP server, a URL the host can reach, and any skills inagent/skills/.
The packages connect to your running server; generating them does not deploy it.
Generate and check the packages
1
Write the plugin output
Run this in the agent’s folder, replacing the example URL with your server’s URL:Add
Terminal
--name my-product to choose a plugin name instead of the package name.2
Validate it
Terminal
3
Load it in your host
Choose the package format your host supports and follow that host’s installation flow.
Try a request that uses one of your skills and tools.Check it worked: the host loads the skill once and calls a tool through
/mcp/plugin.
Directory publication, where available, has its own submission and review process.Generated files
- Claude Code
- Agent Plugins
plugins/claude/
type: "http" and points to /mcp/plugin.Why two MCP endpoints?
Both use the same tools, authentication and descriptor overrides. This gives the host one copy
of each skill.
Change the plugin endpoint
Change the plugin endpoint
Disable it with
mcpServer({ ..., plugin: false }), or change it with
plugin: { path: "/native" }. handle.plugin exposes its path and descriptors.For a custom route, pass its URL ending in /plugin to the generator or update the generated
MCP configuration. The server’s instructions override and extend handlers apply to both paths.Keep it in sync
Regenerate after changing a skill or one of its assets.check --plugin compares content hashes,
so checking out a file cannot make a stale package look current.
Generated manifests and copied skills are rewritten on regeneration. Keep hand-written skills
outside those generated source paths. You can customize the packages and add other components
alongside them. No bearer token is written into either package.
Write portable skills
Keep the workflow in one source folder.
Trace tool calls
Inspect MCP, plugin and CLI calls from the same server.