К основному содержанию
скилл CX Codex

chatgpt-plugin — скилл для Claude Code: проверка и установка

Скилл для Claude Code помогает подготовить ChatGPT-плагин или приложение на Apps SDK к проверке OpenAI. Запускается при разработке, отправке на проверку или изменении такого приложения.

MIT ★ 741 обновлён 2026-11-14

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add phuryn/product-engineering
/plugin install app-stack@product-engineering
Открыть на GitHub

Что делает chatgpt-plugin

Скилл помогает сверить ChatGPT-плагин или приложение на Apps SDK с требованиями каталога OpenAI перед отправкой. Он разбирает вход в каталог, авторизацию, пакет, правила обработки данных и проверку через портал.

В инструкции описаны два варианта публикации: подключение MCP-сервера как custom connector и размещение плагина в каталоге. Для плагина понадобятся сервер и ZIP-пакет с манифестом, mcp.json, как минимум одним скиллом, ресурсами и материалами для проверки. Подключение через custom connector не требует проверки каталога.

Перед загрузкой ZIP проверяет скрипт python <skill dir>/scripts/check_package.py <package dir> --zip <zip>. Значения <skill dir>, <package dir> и <zip> нужно заменить путями к скиллу, пакету и архиву. Требования OpenAI могут меняться, поэтому инструкция велит сверять их страницы перед каждой загрузкой и отправкой.

Какие задачи решает

  • подготовить ChatGPT-плагин к первой отправке в каталог OpenAI
  • сверить авторизацию и данные, которые возвращают инструменты
  • собрать ZIP-пакет с файлами и материалами для проверки
  • отличить подключение custom connector от публикации в каталоге

Примеры запросов агенту

  • Сверь мой ChatGPT-плагин с требованиями каталога OpenAI перед отправкой.
  • Проверь авторизацию и данные, которые возвращают инструменты моего MCP-сервера для ChatGPT.
  • Объясни, что нужно добавить в ZIP-пакет плагина перед загрузкой в портал OpenAI.

Как установить chatgpt-plugin

1Через маркетплейс плагинов

/plugin marketplace add phuryn/product-engineering
/plugin install app-stack@product-engineering

Команда ставит плагин app-stack целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add phuryn/product-engineering --skill chatgpt-plugin -a claude-code

3Вручную: положить файлы

~/.claude/skills/chatgpt-plugin/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/chatgpt-plugin/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о chatgpt-plugin

Как установить chatgpt-plugin в Claude Code?

Выполни команды по порядку: /plugin marketplace add phuryn/product-engineering, затем /plugin install app-stack@product-engineering.

Что делает chatgpt-plugin?

Скилл помогает подготовить ChatGPT-плагин или приложение на Apps SDK к проверке OpenAI. Он охватывает авторизацию, содержимое пакета, данные и требования портала.

Чем custom connector отличается от плагина в каталоге?

Для custom connector подключают URL удалённого MCP-сервера, и проверка каталога не нужна. Плагин для каталога поставляется вместе с ZIP-пакетом и проходит автоматические проверки, затем проверку людьми.

Исходный текст

SKILL.md · MIT
---
name: chatgpt-plugin
description: "Before building, submitting or changing a ChatGPT plugin or Apps SDK app: get it through OpenAI's directory review (auth, package, OAuth, data rules, portal)."
---

# ChatGPT plugin

**Verify the plugin against directory requirements before its first submission.** ChatGPT and Codex share OpenAI's plugin directory. This skill works with any remote MCP server, in any language, behind any OAuth provider or none. The rules use OpenAI's own pages, read on `2026-10-26`, and product submissions.

OpenAI's pages, each available as Markdown by appending `.md`: `developers.openai.com/plugins/deploy/submission`, `/deploy/submission-errors`, `/deploy/app-review`, `/plugin-guidelines`, `/build/plugins`, `/build/auth`, `/reference` and `/deploy/connect-chatgpt`.

## What binds, in order

1. **Follow OpenAI's current pages when they disagree with this skill.** They change without notice and contradicted each other in six places (read `2026-10-26`; § Where OpenAI's pages disagree). Read them again before every upload and every submission, and record the date. Where this skill and a page disagree, the page wins and this skill gets a dated correction.
2. **Use this skill for what OpenAI's pages leave out.** It covers what the portal and reviewers actually did.
3. **Keep the server's own engineering rules for MCP implementation.** This skill covers only what ChatGPT adds to an MCP server. The route, tool descriptions, output schemas and their tests are the `mcp-server` skill's, if you use this collection; this skill does not need it.

## Two ways in

| | Custom connector | Directory plugin |
|---|---|---|
| How a user gets it | adds the server's URL in ChatGPT: Plugins → + → Add custom MCP server (workspace policy permitting) | finds it in the directory, by its link or by name |
| What you ship | a remote MCP server | the server and a ZIP package: manifest, `mcp.json`, at least one skill, assets, review materials |
| Sign-in | whatever the server's OAuth discovery offers | declared in the package: none, OAuth, or both |
| Review | none | automated scans, then people, then daily rescans for as long as it is listed |

**Connect it as a custom connector against production first.** A working custom connector is most of the way there. The directory adds the package, data rules, publishing identity and review. Record the review video this way too. Before approval, the plugin itself runs only as a local install in ChatGPT's desktop app or Codex, never on the web.

## Decide these first, and record them

| Decision | The default | Why it is decided before the first upload | Where |
|---|---|---|---|
| Who signs in | OAuth on the server the product already has, if it has accounts | The portal reads authentication from each upload's `mcp.json`, but an existing connection can lock it | `references/package.md § mcp.json` · `references/portal-and-review.md § Create the draft` |
| Which endpoint | One per plugin, on a host you will keep | Only one MCP server can be connected per plugin, and the origin (scheme, host, port) can never change: a new origin is a new plugin | `references/portal-and-review.md § After publication` |
| Which tools | The everyday actions, minus anything that takes or returns a secret | OpenAI's restricted data includes API keys and passwords, and the review reads the server's own tool list. A server whose setup tools take provider keys needs a narrowed list on a route of its own | `references/tools-and-data.md § Restricted data` |
| Who publishes | The legal entity the privacy policy and terms name, verified on the OpenAI Platform | The directory shows the verified identity chosen when the draft is created, whatever the ZIP says; it must match the legal pages | `references/portal-and-review.md § Before the first upload` |
| Which project | One with global data residency | Projects with EU data residency cannot submit plugins with MCP servers | same |
| Where it is available | Everywhere (`publication.countries` omitted) | An allowlist in the package applies when the plugin is published | `references/package.md § plugin.json` |

## The rules every submission meets

- **Authentication is declared in `mcp.json`, per server, before the first upload.** For a server with no sign-in, never complete an OAuth sign-in in the portal: the connection it makes is kept. `references/package.md § mcp.json`.
- **Discovery answers the portal's scanner.** It called from outside ChatGPT's published address ranges (observed `2026-10-23`). Gate tool calls, not `initialize` and `tools/list`. `references/server-and-auth.md § A surface with no sign-in`.
- **Every request's `params` may carry `_meta`, and the server accepts it.** ChatGPT sends user, session, location, trace and call ids on every tool call (observed `2026-10-27`). OpenAI documents a locale on `initialize`. A parser refusing unknown keys there would refuse every one of those calls. `references/server-and-auth.md § What every request carries`.
- **No tool asks for a secret and no reply contains one.** No reply carries a field the request did not need. `references/tools-and-data.md`.
- **The privacy policy names every field a reply returns.** A test holds the policy and replies equal both ways. Include nested fields and error replies. `references/tools-and-data.md § The privacy policy`.
- **Every tool sets `readOnlyHint`, `destructiveHint` and `openWorldHint` explicitly.** Set `readOnlyHint`, `destructiveHint` and `openWorldHint` on every tool. An irreversible effect is its own tool; an action stays destructive even when another tool can undo it. `references/tools-and-data.md § Annotations`.
- **Review materials travel in the ZIP; credentials never do.** Five positive cases, three negative ones, the video's link and the release notes in `plugin.json`; the reviewer's account in the portal. `references/package.md § plugin.json`.
- **The ZIP is checked, then pinned to the package.** `python <skill dir>/scripts/check_package.py <package dir> --zip <zip>` before every upload; a test in the product's suite holds the same byte-for-byte equality, because the portal reads only the ZIP and a ZIP rebuilt by hand goes stale.
- **Listing copy sells nothing.** No pricing, trials or promotions; nothing that steers the model toward the plugin; no "MCP" or "Plugin" after the name. `references/tools-and-data.md § Names, descriptions and copy`.

## The stage, in order

1. **Record each decision above in the product's decision log.**
2. **Prove the production server works as ChatGPT calls it.** Require `_meta` accepted, discovery open, OAuth meeting ChatGPT's client, the address check (if any) on the caller's own address. Connect it in ChatGPT as a custom connector against production and call every tool; record the date and what was called (`references/server-and-auth.md`).
3. **Narrow the tool list and test every returned field.** Include the list narrowed to what may be listed, replies allowlisted at every depth, annotations, the privacy page's field inventory, and the tests that hold them (`references/tools-and-data.md`).
4. **Build and pin the full submission package.** Include manifest, `mcp.json`, a skill that names the tools, assets, the five and three review cases taken from the routing evals' own file, the checker, and the ZIP pinned (`references/package.md`).
5. **Run routing evals against a local server; record video against production.** Record the video in ChatGPT (`references/server-and-auth.md § Testing before approval`).
6. **Prepare a reviewer account when the server has sign-in.** Give it sample data, no emailed or texted code, a plan on which every case succeeds (`references/portal-and-review.md § Review information`).
7. **Create the draft under the right identity and check authentication before connecting.** Complete the draft under the right identity, the Authentication field checked before connecting, domain verification, the scan, review details, then the checklist in `references/portal-and-review.md § Before you submit`.
8. **Respond to the decision and keep live definitions working after publication.** Then answer or appeal, publish when ready, and keep the live definitions working through every later deploy (`references/portal-and-review.md § After publication`).

Each rule's origin, the case that taught it, is in `receipts.md` beside this file; read it when a rule's edge is unclear.

## How you can tell it worked

Every item the review checks was verified on the deployed build before submitting, and the review came back with no fix request on any of them.

## Files

| File | Holds | Read when |
|---|---|---|
| `references/package.md` | the package's layout, every `plugin.json` field with its limit, `mcp.json`'s authentication, the skill inside the package, what cannot be submitted, pinning the ZIP | building or changing the package |
| `references/server-and-auth.md` | what every ChatGPT request carries, what ChatGPT's OAuth client needs, per-tool `securitySchemes`, a surface with no sign-in, shared addresses, testing before approval | building the endpoint, its OAuth or its address gate; testing it in ChatGPT |
| `references/tools-and-data.md` | restricted data, response minimization, the privacy policy, annotations, names and copy, and the tests that hold them | choosing the tools, shaping replies, writing the privacy page |
| `references/portal-and-review.md` | the account and identity, the draft, connecting and scanning, review information, the review, rejection and appeal, publishing, after publication, and the checklist before submitting | in the portal; answering a review; changing a listed plugin |
| `scripts/check_package.py` | checks a package folder and its ZIP against the rules OpenAI states and the traps met; errors exit 1 | before every upload |
| `scripts/test_check_package.py` | builds a valid package and breaks it one way at a time | after every edit to the checker |

## Where OpenAI's pages disagree

**Follow the stricter reading until OpenAI's pages agree.** These were read on `2026-10-26`; correct this list when they agree.

- **Keep one justification sentence per hint per tool ready.** The guidelines say "Annotation justifications are no longer required." The submission-errors page still lists `justification_required` ("Every MCP tool annotation must include a justification") and a final-submission requirement of "a justification for each value on every MCP tool". Keep one sentence per hint per tool ready; it does not change the hint, which comes from the server.
- **Treat the origin as permanent and a path change as a support conversation.** The submission page says "To change an existing MCP server's URL, contact support; the current update flow does not support URL changes." The review page says a new origin needs a new plugin and a new path goes through the normal new-version flow. Treat the origin as permanent and a path change as a support conversation that may not be needed.
- **Try a corrected ZIP first after a package rejection.** The submission page says "For a rejected package, address the feedback and submit a corrected ZIP." A known issue can prevent updating a rejected plugin, according to OpenAI support (observed `2026-10-19`), with a new plugin as the fallback. Try the corrected ZIP first.
- **Use lowercase letters, numbers and single hyphens for the package `name`.** The submission page asks for "lowercase letters, numbers, and single hyphens"; the submission-errors page allows "ASCII letters, digits, `_`, or `-`". Use the first.
- **Keep the root `description` within 1,024 characters.** "At most 4000 characters" on the submission page, "1,024 characters or fewer" on the submission-errors page. Keep it within 1,024; the checker does.
- **Ship no screenshots without custom UI; write starter prompts instead.** The guidelines say screenshots "are no longer shown in the Directory"; the submission-errors page allows them only when the tool scan reports a UI output template, one per starter prompt, exactly 706 px wide and 400–860 px tall. Without custom UI, ship none and write starter prompts instead.

## When something is learned

- **This skill is general and will be published.** Write the rule and why it holds; a product appears only as an example, named by kind, never by its name, listing or plugin id, commits, paths or account names.
- **Date what OpenAI did or required.** Use "read on" or "observed in". When it changes, correct the line; never leave the old one beside the new.
- **What is true of one product goes in that product's repository.** This includes its plugin's id, package versions, review states and dates, the identity it publishes under, its verified clients.
- **A rule a test or the checker can hold gets one.** Say what it asserts.

© Paweł Huryn · MIT · phuryn/product-engineering

Похожие скиллы

Каталог скиллов SKILL.md →
chatgpt-app-builder alpic-ai Скилл chatgpt-app-builder для Claude Code и Codex: построение плагинов ChatGPT и MCP-серверов на всех этапах разработки — от идеи и архитектуры через реализацию инструментов и интерфейсов до развёртывания и подключения к ChatGPT. CX Codex +1 7 200установок chatgpt-codex-onboarding starchild Скилл chatgpt-codex-onboarding подключает подписку ChatGPT или Codex через OAuth device-code, чтобы работать с моделями gpt-5-codex без API-ключа. CX Codex +1 2 500установок scenario-chatgpt-pet-update scenario-labs Скилл scenario-chatgpt-pet-update обновляет спрайт-листы питомцев ChatGPT и Codex через Scenario: чинит анимации, меняет цвета и генерирует предпросмотр в GIF. CX Codex +1 592установок scenario-chatgpt-pet-create scenario-labs Скилл scenario-chatgpt-pet-create создаёт питомца для ChatGPT или Codex из текста и референсов: спрайт-листы, GIF и пакет pet.json. CX Codex +1 591установок chatgpt-app-submission официальный OpenAI Скилл chatgpt-app-submission проверяет MCP-сервер ChatGPT Apps и готовит файл для подачи приложения. Пригодится перед ревью, когда нужно собрать подсказки, тесты и замечания. CX Codex GP ChatGPT +1 29установок build-chatgpt-app официальный OpenAI Скилл build-chatgpt-app для Codex помогает собирать и менять приложения на ChatGPT Apps SDK с MCP-сервером и интерфейсом-виджетом. Сначала он направляет к актуальной документации и примерам. CX Codex GP ChatGPT +1 16установок

Из того же набора51

Весь набор →
grok-agents Скилл grok-agents для Claude Code запускает Grok CLI из другого агента как партнёра, исполнителя или независимого ревьюера. Он подключается к просьбам привлечь Grok к обсуждению решения, этапу разработки или проверке изменений. CX Codex +1 ★ 741звёзд репо shipping-artifacts Скилл shipping-artifacts для Claude Code создаёт комплект технической документации для аудита и передачи кода. Фиксирует архитектуру, сценарии с проверками прав, переменные окружения и карту покрытия тестами. CX Codex +1 ★ 741звёзд репо saas-authorization Скилл saas-authorization для Claude Code проверяет права доступа, мультиарендность и безопасность в SaaS-приложениях. Подключается при запросах на добавление авторизации, ролей и работы с данными. CX Codex +1 ★ 741звёзд репо derive-tests Скилл derive-tests для Claude Code строит карту покрытия по документации и коду. По запросу «что тестировать» он находит пробелы, а в режиме check проверяет актуальность карты. CX Codex +1 ★ 741звёзд репо embedded-agents-messages-api Скилл embedded-agents-messages-api для Claude Code помогает встроить Claude-агента через Messages API в приложение на Next.js. Он подключается при создании агента или чата с агентом внутри приложения. CX Codex +1 ★ 741звёзд репо code-review Скилл code-review для Claude Code ищет дефекты кода и проверяет каждое подозрение на контрпример. По запросу «проверь код» он оценивает корректность; измерения производительности и безопасности можно выбрать отдельно. CX Codex +1 ★ 741звёзд репо propose Скилл propose для Claude Code исследует продуктовую идею, собирает альтернативы и формирует интерактивное предложение с экранами интерфейса. Запускается на вопросах «стоит ли это делать» и «что пилить дальше». CX Codex +1 ★ 741звёзд репо ui-design Скилл ui-design для Claude Code задаёт правила дизайна интерфейсов и проверки экранов. Подключается при создании экранов, прототипов и макетов продукта. CX Codex +1 ★ 741звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой