Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 12 additions & 10 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@ installs, or publishes a plugin component:
5. Record the consulted URLs and verification date in the pull request. Link to
upstream material; do not copy its prose or examples into this repository.

Read only the sections relevant to the action, but do not skip the preflight.
Within the live upstream pages, read only the sections relevant to the action,
but do not skip the preflight.
When live official documentation and verified product behavior disagree, stop
contract-changing work, record the discrepancy, and prefer the narrower
behavior until it is resolved. Update `docs/official-docs.md` when a pointer
Expand Down Expand Up @@ -82,10 +83,9 @@ paths, tool installation, subscription, or credentials as a consumer default.

- Scaffold or update plugins by hand from the
[plugin packaging guide](https://developers.openai.com/plugins/build/plugins),
and skills with `$skill-creator`. Codex CLI 0.159.0 removed `$plugin-creator`;
the guide still offers `@plugin-creator` in ChatGPT Work mode and
`$plugin-creator` on other Codex surfaces, so check the page before relying
on either.
and skills with `$skill-creator`. The Codex CLI ships no `$plugin-creator`;
the [cheat sheet](docs/codex-capability-cheat-sheet.md#built-in-system-skills)
records the version and what the guide offers on other surfaces.
- Keep every skill focused on one recognizable goal. Put essential procedure in
`SKILL.md` and detailed variants in directly linked `references/` files.
- Keep `agents/openai.yaml` aligned with its skill. It is the harness-facing
Expand Down Expand Up @@ -114,11 +114,13 @@ npm test
npm run validate
```

`npm run validate` is the plugin and catalog validator; Codex CLI 0.159.0
removed the built-in one. Also run the `$skill-creator` quick validator for every
changed skill, and behavioral tests for direct, indirect, negative, missing
dependency, and repository-context cases. Migration validation must use a new
Codex task with the source marketplace and sibling plugins disabled.
`npm run validate` is the plugin and catalog validator; the Codex CLI ships
none. Also run the `$skill-creator` quick validator for every changed skill,
and behavioral tests for every case the
[release gates](docs/plugin-philosophy.md#release-gates) name. Migration
validation must use a new Codex task with the source marketplace and sibling
plugins disabled, and exercises the
[playbook matrix](docs/migration-playbook.md#8-validate-the-target-in-isolation).

The pull request must state:

Expand Down
5 changes: 3 additions & 2 deletions docs/codex-capability-cheat-sheet.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,8 +68,9 @@ Codex CLI 0.159.0 removed the bundled `plugin-creator` skill
([#48604](https://github.com/openai/codex/pull/48604)), so `$plugin-creator`
no longer resolves from the CLI binary. The
[plugin packaging guide](https://developers.openai.com/plugins/build/plugins)
still names `@plugin-creator` as a built-in in ChatGPT; check that page before
relying on it.
still offers `@plugin-creator` in ChatGPT Work mode and `$plugin-creator` on
other Codex surfaces (read 2026-11-14); check that page before relying on
either.

## Plugin-author changes since 0.143.0

Expand Down
10 changes: 5 additions & 5 deletions docs/migration-playbook.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,9 +121,9 @@ to preserve the source file shape.

Write the target package's manifest and marketplace entry by hand from the
[plugin packaging guide](https://developers.openai.com/plugins/build/plugins);
Codex CLI 0.159.0 removed the bundled `$plugin-creator` skill. The guide still
offers `@plugin-creator` in ChatGPT Work mode and `$plugin-creator` on other
Codex surfaces; check the page before relying on either. Use `$skill-creator` for each
the Codex CLI ships no `$plugin-creator` skill (see the
[cheat sheet](codex-capability-cheat-sheet.md#built-in-system-skills)).
Use `$skill-creator` for each
skill; it is a built-in system skill, so it takes the bare `$name` form. Use
the installed `$plugin-ops:migrate-plugin` component map as a checklist, then
override it when current official documentation differs. Skills that ship inside
Expand Down Expand Up @@ -160,8 +160,8 @@ write to a broader scope, or change the user goal.

## 8. Validate the target in isolation

Run the repository validator (`validate-marketplace.mjs`, which replaces the
built-in plugin validator Codex CLI 0.159.0 removed) and the `$skill-creator`
Run the repository validator (`validate-marketplace.mjs`; the Codex CLI ships
no plugin validator) and the `$skill-creator`
quick validator. Then install the target from a local marketplace and start a new
Codex task with the source marketplace and sibling plugins disabled.

Expand Down
2 changes: 1 addition & 1 deletion plugins/plugin-ops/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "plugin-ops",
"version": "0.2.4",
"version": "0.2.5",
"description": "Install, update, migrate, and validate Codex plugins and marketplace catalogs.",
"author": {
"name": "Melodic Software",
Expand Down
8 changes: 4 additions & 4 deletions plugins/plugin-ops/skills/migrate-plugin/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ assumptions.

1. Record the source repository, exact commit, version, and target base commit.
Read every source component and its tests before editing.
2. Fetch current official documentation for both the source host and Codex. In
this marketplace, complete the root `AGENTS.md` preflight and read
`docs/plugin-philosophy.md` plus `docs/migration-playbook.md`. Record live
URLs and the date checked; copy no upstream prose.
2. Fetch current official documentation for both the source host and Codex.
When the active repository has them, complete the root `AGENTS.md` preflight
and read `docs/plugin-philosophy.md` plus `docs/migration-playbook.md`.
Record live URLs and the date checked; copy no upstream prose.
3. Define the user-goal vertical slice: inputs, repository context, output,
side effects, boundaries, platform variants, and acceptance evidence.
4. Read [references/component-map.md](references/component-map.md), then create
Expand Down
2 changes: 1 addition & 1 deletion tests/plugin-ops-plugin.test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ const paths = skillPaths("plugin-ops");
test("the marketplace exposes the Plugin Ops plugin", async () => {
await assertMarketplacePlugin({
name: "plugin-ops",
version: "0.2.4",
version: "0.2.5",
category: "Developer Tools",
});
});
Expand Down
Loading