Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

codex-desktop-plugins

/codex-desktop-plugins

Opisuje pakowanie, instalację, testowanie, udostępnianie i zgłaszanie wtyczek do aplikacji desktopowej ChatGPT (dawniej Codex): plugin.json, skille, serwery MCP, hooki, marketplace.json i konfigurację.

Repozytorium
mental ↗
Licencja
MIT
Ostatnia zmiana repozytorium
08.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Opisuje pakowanie, instalację, testowanie, udostępnianie i zgłaszanie wtyczek do aplikacji desktopowej ChatGPT (dawniej Codex): plugin.json, skille, serwery MCP, hooki, marketplace.json i konfigurację.

Oryginalny opis (EN)

Package, install, test, share and submit plugins for the ChatGPT desktop app (formerly the Codex app): the portable plugin.json or .codex-plugin layout, extensions.com.openai settings, bundled skills and MCP servers, hooks, marketplace.json, install cache paths, .codex/config.toml, workspace publish and public directory submission. Use when the user wants to create, ship or debug a ChatGPT or Codex desktop plugin and needs its requirements.

Jak działa

  1. Requirements
  2. Layouts
  3. Workflow
  4. Hooks
  5. Safety
  6. Verification checklist
  7. Anti-patterns
  8. Pointers
Sekcje z nagłówków SKILL.md, w oryginale · 86 linii, 729 słów
Podgląd SKILL.md
---
name: codex-desktop-plugins
description: >-
  Package, install, test, share and submit plugins for the ChatGPT desktop app
  (formerly the Codex app): the portable plugin.json or .codex-plugin layout,
  extensions.com.openai settings, bundled skills and MCP servers, hooks,
  marketplace.json, install cache paths, .codex/config.toml, workspace publish
  and public directory submission. Use when the user wants to create, ship or
  debug a ChatGPT or Codex desktop plugin and needs its requirements.
license: MIT
compatibility: Needs a ChatGPT desktop app with plugins enabled (macOS or native Windows). Optional Codex CLI for codex plugin marketplace commands. Public submission needs a platform.openai.com organization with verified developer identity.
metadata:
  author: Ali Farahat
  tags: chatgpt-desktop,codex,plugins,marketplace,submission
  verified-against: developers.openai.com/plugins/build/plugins and deploy/submission
when_to_use: |
  USE WHEN:
  - The user wants to create, package, install, share or submit a ChatGPT /
    Codex desktop plugin, or asks what a plugin needs (manifest, skills, MCP,
    marketplace, review test cases).
  - They mention plugin.json, .codex-plugin, .agents/plugins/marketplace.json,
    @plugin-creator, "Add custom MCP server", or plugin submission.

  DO NOT USE WHEN:
  - The task is the UI inside the plugin (entrypoints, MCP Apps): use
    codex-desktop-extensions.
  - The task is writing a SKILL.md: use codex-desktop-skills.
  - The user wants Claude Desktop plugins: use claude-desktop-plugins.
---

# ChatGPT / Codex desktop plugins

A plugin bundles **skills**, optionally an **MCP server** (tools, plus UI via `codex-desktop-extensions`), and listing metadata. Sources (re-check; they change): `https://developers.openai.com/plugins/build/plugins.md`, `.../deploy/submission.md`, `.../plugin-guidelines`, index `https://developers.openai.com/llms.txt`. The ChatGPT/Codex docs live at `https://learn.chatgpt.com/docs/`.

## Requirements

1. A manifest at the plugin root, in one of two accepted formats (below).
2. Every path in the manifest starts with `./`, is relative to the plugin root and stays inside it.
3. Skills in `skills/<name>/SKILL.md` (auto-discovered), each with `name` and `description`.
4. If it has tools: an MCP config declaring one or more servers.
5. Listing metadata (`interface`): name, descriptions, developer, category, icons.
6. For public submission: `review` test cases (5 positive, 3 negative), a walkthrough video URL, release notes, privacy and terms URLs, a public HTTPS MCP server and a verified domain.

## Layouts

**Portable Agent Plugins format** (preferred for new work): root `plugin.json` with `$schema`, OpenAI-specific settings under `extensions.com.openai`, `skills/`, `mcp.json`.

**Codex compat format** (still supported; what `@plugin-creator` scaffolds): `.codex-plugin/plugin.json` with `skills`, `mcpServers` and a root `interface` block, plus `.mcp.json` (no `$schema`, no `type`). Onboarding, review and publication stay under `extensions.com.openai`. When `extensions.com.openai` is an object it **fully replaces** the `.codex-plugin` overlay; the two are not merged.

Claude-style manifests and `.claude-plugin/marketplace.json` are accepted too. Field tables and examples: [references/manifest.md](references/manifest.md).

```text
acme-notes/
  plugin.json
  mcp.json
  assets/        icons, logo, screenshots
  skills/<name>/SKILL.md
```

## Workflow

1. **Scaffold** with `@plugin-creator` (Work mode) or `$plugin-creator` (Codex), or by hand from [references/manifest.md](references/manifest.md). Use a stable kebab-case `name`; it is the identity.
2. **Add skills** (`codex-desktop-skills`) and, if needed, the MCP server and UI (`codex-desktop-extensions`).
3. **Add a marketplace entry** to install locally: [references/marketplaces-and-install.md](references/marketplaces-and-install.md).
4. **Restart the desktop app.** It loads from `~/.codex/plugins/cache/<marketplace>/<plugin>/<version>/`.
5. **Test** skills with direct, indirect and negative prompts; test MCP tools and UI entrypoints.
6. **Share**: repo marketplace for a team, workspace publish for an organization, or public submission: [references/submission.md](references/submission.md).
7. **Bump `version`** for every release; changed packages need a new ZIP when submitted.

## Hooks

`hooks/hooks.json` is discovered by default; an explicit manifest `hooks` value replaces default discovery. Env vars: `PLUGIN_ROOT`, `PLUGIN_DATA` (and `CLAUDE_PLUGIN_ROOT`, `CLAUDE_PLUGIN_DATA`). Hooks apply only to manually installed desktop plugins and are skipped until the user reviews and trusts them. **A plugin with hooks cannot be submitted to the public directory**; remove them before submission. Docs: `https://learn.chatgpt.com/docs/hooks`.

## Safety

- Never put secrets, tokens or credentials in the plugin folder or ZIP. Use per-user auth (`policy.authentication`) and server-side secrets.
- Hooks execute shell commands; keep them minimal, document them and never run them silently.
- Keep marketplace `source.path` inside the marketplace root; never point it at `..` or absolute paths.
- Do not ask reviewers to run private-network or MFA-gated setups; supply credentials without MFA.
- MCP tool approval: set conservative `default_tools_approval_mode` and per-tool `approval_mode` for destructive tools.
- Do not tag, publish or submit on the user's behalf without explicit confirmation.

## Verification checklist

- [ ] Manifest parses as JSON; all paths begin with `./` and resolve inside the plugin
- [ ] `name` is stable kebab-case; `version` bumped
- [ ] Each skill has `name` and a trigger-rich `description`
- [ ] `extensions.com.openai` chosen deliberately (it replaces the `.codex-plugin` overlay)
- [ ] MCP config valid; at most one remote MCP server if submitting
- [ ] No hooks and no `apps`/`.app.json` references if submitting to the public directory
- [ ] Marketplace entry has `name`, `source`, `policy`, `category`
- [ ] Reinstalled and app restarted after changes
- [ ] 5 positive and 3 negative review cases, video, release notes (submission)
- [ ] No secrets anywhere in the package

## Anti-patterns

- Editing the cache directory instead of the source plugin.
- Mixing `.codex-plugin/plugin.json` overlay fields with `extensions.com.openai` and expecting a merge.
- Absolute paths or `../` in manifest or marketplace paths.
- Shipping hooks and then submitting to the public directory.
- Adding an MCP server to an already published skills-only plugin (unsupported; changing the server URL needs support).
- Vague skill descriptions, so skills never trigger.
- Changing `name` between versions (breaks identity and installs).

## Pointers

| Need | Read |
| --- | --- |
| Manifest fields, examples, MCP config | [references/manifest.md](references/manifest.md) |
| Marketplaces, install cache, config.toml, CLI | [references/marketplaces-and-install.md](references/marketplaces-and-install.md) |
| Workspace publish, public submission, review | [references/submission.md](references/submission.md) |
| UI entrypoints and MCP Apps | `codex-desktop-extensions` |
| SKILL.md authoring | `codex-desktop-skills` |
Pliki w paczce (4)
  • SKILL.md 7 KB
  • references/manifest.md 4 KB
  • references/marketplaces-and-install.md 3 KB
  • references/submission.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie codex-desktop-plugins.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 6df964ce3897 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90Codex CLI Plugins
    Tworzy wtyczki Codex CLI: manifest, pakowanie skilli, marketplace i lokalną instalację.
  • 100codex-desktop-skills
    Pomaga pisać, naprawiać i testować Agent Skills dla aplikacji desktopowej ChatGPT (dawniej Codex): frontmatter SKILL.md, opisy z wyzwalaczami, układ plików, agents/openai.yaml i testy aktywacji.
  • 100claude-desktop-plugins
    Tworzy, waliduje i publikuje wtyczki Claude dla Claude Desktop i Claude Code: plugin.json, skille, polecenia, agentów, haki, serwery MCP i LSP, userConfig oraz marketplace i katalog Anthropic.
  • 90Claude Code Plugin Builder
    Tworzy pluginy Claude Code z manifestem, strukturą katalogów i komponentami: komendami, agentami, skillami, hookami i MCP.
  • 100publish-skills
    Publikuje skille agentów i serwery MCP we wszystkich marketplace'ach i rejestrach: skan prywatnych danych, walidacja, wydanie, marketplace'y Claude i Codex oraz oficjalny MCP Registry.
  • 95plugin-writer
    Tworzy od zera wtyczki Claude Code z odpowiednią strukturą katalogów i metadanymi, konfiguruje serwery MCP i dopisuje je do marketplace.json.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.