plugin-creator

A toolset for creating Codex add-on folders with the required plugin manifest and optional marketplace entry. It provides a scaffold script and rules for valid names and metadata.

In plain words
What is it for?
Starting a new Codex plugin, generating its .codex-plugin/plugin.json file, adding optional folders, and creating or updating a personal marketplace entry.
Why use it?
It avoids assembling the required plugin files and defaults by hand. It also supports listing a personal plugin in the Codex interface through a marketplace file.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/extracurricular-ai/codex-rewind/plugin-creator
Any agent
npx skills add extracurricular-ai/codex-rewind --skill plugin-creator
Clone the repo
git clone --depth 1 https://github.com/extracurricular-ai/codex-rewind

Made for: Claude Code, Codex.

Per session 86 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,422 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 98% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00086 $0.02422
Opus 5 $0.00043 $0.01211
Sonnet 5 $0.00017 $0.00484
Haiku 4.5 $0.00009 $0.00242

Measured 2d ago against content hash 8fd56316b2c4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plugin-creator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 4 executable files (scripts/create_basic_plugin.py, scripts/read_marketplace_name.py, scripts/update_plugin_cachebuster.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

98% identical to plugin-creator — 12 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

codex-rs/skills/src/assets/samples/plugin-creator/SKILL.md · 244 lines

How it starts

The opening of the file, as written. The whole thing — 244 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Plugin Creator

Quick Start

  1. Run the scaffold script:
# Plugin names are normalized to lower-case hyphen-case and must be <= 64 chars.
# The generated folder and plugin.json name are always the same.
# Run from the skill root (the directory containing this `SKILL.md`).
# By default creates in `~/plugins/<plugin-name>`.
python3 scripts/create_basic_plugin.py <plugin-name>
  1. Edit <plugin-path>/.codex-plugin/plugin.json when the request gives specific metadata. The scaffold starts with valid defaults and must not contain [TODO: ...] placeholders.

  2. Generate or update the personal marketplace entry when the plugin should appear in Codex UI ordering:

# Personal marketplace entries default to `~/.agents/plugins/marketplace.json`.
python3 scripts/create_basic_plugin.py my-plugin --with-marketplace

Only specify --marketplace-name <name> when the default personal marketplace name is already taken or installed and you need to seed a different new marketplace file:

python3 scripts/create_basic_plugin.py my-plugin \
  --with-marketplace \
  --marketplace-name team-local

Only use a repo/team marketplace when the user specifically asks for that destination:

python3 scripts/create_basic_plugin.py my-plugin \
  --path <repo-root>/plugins \
  --marketplace-path <repo-root>/.agents/plugins/marketplace.json \
  --with-marketplace

When the user specifies a marketplace path, make sure that marketplace is actually installed before telling the user to reinstall from it. The default personal marketplace file at ~/.agents/plugins/marketplace.json is discovered implicitly, but other marketplace paths are not. On Windows, use the equivalent path under the user profile.

  1. Generate/adjust optional companion folders as needed:
python3 scripts/create_basic_plugin.py my-plugin \
  --path <parent-plugin-directory> \
  --marketplace-path <marketplace-json-path> \
  --with-skills --with-hooks --with-scripts --with-assets --with-mcp --with-apps --with-marketplace

Read the full file on GitHub · 244 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 244 lines · 86 tokens per session scan A 8fd56316b2c4

Subscribe to this mod's changes

plugin-creator is a skill published in the GitHub repository extracurricular-ai/codex-rewind (44 stars, last pushed 6d ago), licensed Apache-2.0. It adds 86 tokens to every session and 2,422 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 98% identical to plugin-creator, differing in 12 lines, and is treated as a copy.

Related

Other skills, from other repositories

intuitive-doc

Create and maintain an intuitive human documentation surface for AI-agent-developed repos. Use when humans should only need README.md, ARCHITECTURE.md, STATUS.md, and docs/human/ while planning logs, generated docs, retrospectives, ADR detail, and implementation evidence stay in AI-agent-only folders.

MiaoDX/intuitive-flow · 64 tokens

skill-runner

Run a bounded development task through named skills in an isolated, tmux-backed Codex or Claude session. Use for durable or artifact-sensitive worker phases, supervised skill runs, and post-run skill evaluation.

MiaoDX/intuitive-flow · 45 tokens

plan-bakeoff

Run one approved implementation plan through multiple isolated candidate worktrees, then compare artifacts and rank the results. Use for best-of-N implementation or agent/model/harness bakeoffs against one shared baseline.

MiaoDX/intuitive-flow · 45 tokens

intuitive-init

Initialize, audit, aggressively slim, merge, and refresh project-local AGENTS.md and CLAUDE.md files from existing repo guidance, agent /init suggestions, stdin-bundled Codex init-style discovery, and intuitive workflow defaults. Use when setting up a repo for Claude Code/Codex, replacing symlinked agent files with…

MiaoDX/intuitive-flow · 197 tokens

agent-planning-loop

Run a bounded autonomous planning loop before implementation: use scout workers to apply intuitive-reduce-entropy and grill-with-docs-batch, keep the main session as judge, iterate until the scope is clear, then present one recommended plan plus alternatives for a single user review. Follow the skill-runner Codex…

MiaoDX/intuitive-flow · 136 tokens

context-forge

Use when starting a brand-new project that needs AI-agent context (CLAUDE.md, AGENTS.md, skills, rules, MCP, spec workflow) set up from day one. Discusses goals → matches catalog know-how → creates a new GitHub repo with everything wired in. Keywords: harness engineering, bootstrap project, context engineering…

glowElephant/context-forge · 82 tokens