SpyBara
Go Premium

build-plugins.md 2026-07-23 21:57 UTC to 2026-07-24 15:00 UTC

78 added, 681 removed.

2026
Fri 24 15:00 Thu 23 21:57 Wed 22 20:02 Tue 21 22:02 Mon 20 23:01 Fri 17 22:57 Thu 16 20:57 Wed 15 19:58 Tue 14 17:03 Wed 8 02:01 Mon 6 22:58

Build plugins

To build or submit a plugin, use the complete builder documentation on developers.openai.com.

Build and submit a plugin

This page provides a brief introduction. A plugin is an installable package that can include skills, an MCP server, or both. An MCP server can also return optional UI.

ChatGPT and Codex share one universal plugin directory. Publish a public plugin once to make the same listing discoverable from supported surfaces in both products. During development, use a local marketplace to test the package before submitting it to the universal directory.

Start with a skill when you are still iterating on one personal workflow. Build a plugin when you want to share that workflow, package related skills, connect to an external service, or distribute a stable capability to a team.

Create a plugin with @plugin-creator

For the fastest setup, use the built-in @plugin-creator skill in ChatGPT Work mode or $plugin-creator in Codex.

<CodexScreenshot alt="Plugin creator skill in ChatGPT" lightSrc="/images/codex/plugins/plugin-creator.png" darkSrc="/images/codex/plugins/plugin-creator-dark.png" />

Describe the outcome, the skills or MCP server to include, and whether you want a local marketplace entry for testing. For example:

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

The skill creates the required .codex-plugin/plugin.json manifest, organizes the plugin folder, and can add the plugin to a local marketplace.

<CodexScreenshot alt="Invoking the plugin creator skill" lightSrc="/images/codex/plugins/plugin-creator-invoke.png" darkSrc="/images/codex/plugins/plugin-creator-invoke-dark.png" />

After it finishes:

  1. Review .codex-plugin/plugin.json.
  2. Check each bundled skill under skills/.
  3. Refresh ChatGPT or Codex and install the plugin from its local marketplace source.
  4. Test the plugin in a new conversation with representative requests.

If the plugin includes an MCP server, first build and test that server, then give @plugin-creator the registered connection details. Follow the complete MCP server workflow for tools, authentication, deployment, and testing.

Create a skills-only plugin manually

A minimal plugin contains a manifest and at least one skill:

meeting-follow-up/
├── .codex-plugin/
│   └── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

Create .codex-plugin/plugin.json:

{
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps",
  "skills": "./skills/"
}

Then add skills/meeting-follow-up/SKILL.md:

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

Use a stable plugin name in kebab case. Keep the skill description specific enough for ChatGPT and Codex to recognize when the workflow applies.

Use @plugin-creator to add the folder to a local marketplace, then install and test it before sharing it.

Continue with the builder documentation

For complete builder documentation, use the Plugins documentation. It covers:

To browse, install, enable, or remove plugins, see Use plugins.