Repository navigation
fix(plugin-ops): stop citing the removed $plugin-creator skill - #114
Conversation
Codex CLI 0.159.0 removed the bundled plugin-creator skill (openai/codex#48604). Scaffolding now points at the packaging guide's hand-written manifest and marketplace entry, validation at validate-marketplace.mjs plus $skill-creator, and the local-plugin refresh at codex plugin remove + add. The guide's @plugin-creator is named as a ChatGPT Work mode skill. plugin-ops goes to 0.2.2. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The guide still offers @plugin-creator in ChatGPT Work mode and $plugin-creator on Codex surfaces beyond the CLI, so the text no longer says "only in ChatGPT Work mode" and points readers at the page instead. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
Claude finished @kyle-sexton's task in 3m 20s —— View job Code reviewReviewed the diff against
Findings (2, both confirmed by independent verification):
Not flagged / verified only as author-claimed: I did not independently run |
|
Claude finished @kyle-sexton's task in 1m 2s —— View job CI security review (
|
|
claude-security-review has reviewed this pull request through 9e57b28; a later push is reviewed from there. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: d28d5664e2
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
claude-review has reviewed this pull request through 9e57b28; a later push is reviewed from there. |
AGENTS.md, migration-playbook section 8, and migrate-plugin step 10 still required the built-in plugin validator Codex CLI 0.159.0 removed; they now name validate-marketplace.mjs and the $skill-creator quick validator. update-plugins validates the local source before `codex plugin remove` and says what to do when the following `add` fails. AGENTS.md names both plugin-creator invocation forms, matching README and the playbook. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Claude finished @kyle-sexton's task in 1m 4s —— View job CI security review (
|
|
Claude finished @kyle-sexton's task in 2m 22s —— View job Claude is reviewing this PR
|
No related issue: findings from a prompt audit of this repository's
instruction files, fixed in the same session.
## Summary
Five places where instruction files disagreed with each other or with
the repository's own standards. Documentation and one skill sentence; no
behavior of the validator or scripts changes.
- **User goal and vertical slice:** an agent reading `AGENTS.md`, the
playbook, the cheat sheet or `migrate-plugin` gets one answer per
question.
- **Native surfaces selected:** `AGENTS.md`, repository docs, one
`SKILL.md`. No new mechanism.
- **Ports and adapters introduced:** none.
- **Defaults, configuration, and fallbacks:** `migrate-plugin` step 2
now applies the repository preflight only when the active repository has
the named files; otherwise it falls back to the official-documentation
fetch in the same step.
- **Context inputs and precedence:** unchanged.
- **Migration dispositions:** not a migration.
## Fix
1. `AGENTS.md` preflight: "Read only the sections relevant" contradicted
"read all of" two docs. It now scopes the live upstream pages, matching
`docs/official-docs.md` ("Read the smallest complete set").
2. `docs/codex-capability-cheat-sheet.md`: the guide claim said only
"`@plugin-creator` as a built-in in ChatGPT"; the copies added in #114
were fuller. Brought up to the guide's current wording.
3. `AGENTS.md` and `docs/migration-playbook.md`: the `$plugin-creator`
removal was restated as a version history note
(`docs/standards/reference-dont-duplicate.md`, "History lives in version
control"). Both now state the current rule and link the cheat sheet,
which holds the version, date and recheck trigger. `README.md` and the
two skills keep their copies: onboarding prose may restate, and an
installed skill cannot link repository docs.
4. `AGENTS.md` validation: listed five behavioral cases where the
release gates list seven. It now cites the release gates and the
playbook matrix.
5. `plugins/plugin-ops/skills/migrate-plugin/SKILL.md`: "In this
marketplace" is not something an installed copy can detect. Now "When
the active repository has them". `plugin-ops` 0.2.4 to 0.2.5.
## Verification
- `npm test`: 202 pass, 0 fail, 0 skipped.
- `npm run validate`: PASS, 0 errors, 0 warnings.
- `lychee --offline` on the three edited docs: 0 errors (the two new
anchors resolve).
- Live page consulted 2026-11-14:
https://developers.openai.com/plugins/build/plugins. It names
`@plugin-creator` in Work mode in ChatGPT and `$plugin-creator` in
Codex, which is what fix 2 records.
- Not run: the `$skill-creator` quick validator and a behavioral run of
`migrate-plugin` in a new Codex task. This session has no Codex CLI task
surface; the changed sentence is covered structurally by
`tests/plugin-ops-plugin.test.mjs`.
## Related
- #114 (introduced the copies), #111 (cheat sheet wording).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_015XWwmeQBXsRaYpmqMJbwsf
---------
Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>

Closes #112
Summary
Codex CLI 0.159.0 removed the bundled
plugin-creatorskill (openai/codex#48604), but seven places in this repository still told plugin authors to use$plugin-creator. Each one now names what authors use today. The plugin packaging guide still offers@plugin-creatorin ChatGPT Work mode and$plugin-creatoron Codex surfaces other than the CLI. The docs now name the CLI removal and point readers at the guide for those other surfaces, instead of deleting the mention.Fix
README.md$plugin-creatorand$skill-creatorplugin-creatorsurfaces are named with "check the page"; skills use$skill-creatorAGENTS.mddocs/migration-playbook.md§6$plugin-creatorfor the target packagemigrate-pluginstep 6$plugin-creatorupdate-pluginsstep 5$plugin-creatorcachebuster/reinstall workflowcodex plugin remove <plugin>@<marketplace>thencodex plugin add <plugin>@<marketplace>;marketplace upgradestays in step 3 for Git sources onlyverify-pluginstep 8$plugin-creatorvalidator and the$skill-creatorquick validator$skill-creatorquick validator; the package and catalog check isvalidate-marketplace.mjsfrom step 3tests/plugin-ops-plugin.test.mjs$plugin-creatorcodex plugin removestep and that$plugin-creatoris absentplugin-opsgoes from 0.2.1 to 0.2.2. The cheat sheet already records the removal from #111 and is unchanged.Verification
npm test: 115 pass, 0 fail.npm run validate: PASS, 0 errors, 0 warnings.codex-cli 0.162.0has noplugin-creatorin~/.codex/skills/.system, which holds imagegen, openai-docs, review-agent, skill-creator and skill-installer.codex plugin --helpand the help foradd,removeandmarketplace upgrade.upgradeonly refreshes configured Git marketplace snapshots.plugin-creatorskill openai/codex#48604, merged 2026-09-27.@plugin-creatorin ChatGPT Work mode and$plugin-creatorin Codex, and documents the manual manifest and marketplace route.Pre-ready review
codex plugin removefollowed byaddresets a plugin's enabled state. The existing step 4 reinstall has the same exposure, so this PR adds nothing new there.Related
🤖 Generated with Claude Code