Dev & Engineering ✓ OpenAI · Official

Codex Plugin Builder

Scaffold, validate, and maintain standards-shaped plugins for Codex.

55/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex
Stars
★ 129k
Last updated
11d ago
License
Apache-2.0
plugin-scaffoldingmarketplace-managementmanifest-validationpython-scripts
+1codex-cli

What does this skill do, and when should you use it?

Plugin Creator is a Codex-focused scaffolding skill for creating plugin directories with the required `.codex-plugin/plugin.json`. It can also initialize optional skills, hooks, scripts, assets, MCP, and app structures, while managing personal marketplace entries. For existing local plugins, it provides a cachebuster update flow and validation command. Personal-marketplace support is the default; repository or team marketplaces are opt-in.

Runs scripts/create_basic_plugin.py to normalize a plugin name into lowercase hyphen-case, create the plugin root and a valid plugin.json, and optionally create companion folders and .mcp.json or .app.json. With --with-marketplace, it creates or updates the default ~/.agents/plugins/marketplace.json. It can read marketplace names, validate generated plugins with scripts/validate_plugin.py, and update an existing local plugin with scripts/update_plugin_cachebuster.py.

Good fit
  • A developer needs a personal Codex plugin scaffold with a valid manifest.
  • A plugin author wants optional skills, hooks, scripts, or assets initialized together.
  • A Codex user wants a new plugin added to the personal marketplace.
  • A developer is iterating on a local plugin and needs the documented cachebuster update flow.
  • A maintainer wants to validate a plugin structure before handing it back.

How do you install this skill?

Before you use it
  • Before first use, confirm the target paths and the scope of --force; a later marketplace failure may leave the scaffolded plugin directory behind.
  • Static review did not verify Codex CLI availability, PyYAML installation, platform paths, or actual reachability from mainland-China networks.
  • Do not pass sensitive paths, marketplace configuration, or plugin contents to unreviewed external commands; the update flow has no automatic rollback.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • Python 3

The supplied material does not document a standalone installation command for this skill. The file is located at codex-rs/skills/src/assets/samples/plugin-creator/SKILL.md in the repository. To use it with Codex, install Codex CLI as described in the README, for example with npm install -g @openai/codex, then run codex.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/openai/codex.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/codex-rs/skills/src/assets/samples/plugin-creator" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

From the skill root containing SKILL.md, run python3 scripts/create_basic_plugin.py my-plugin. To add a personal marketplace entry, run python3 scripts/create_basic_plugin.py my-plugin --with-marketplace; add --with-skills, --with-hooks, --with-scripts, --with-assets, --with-mcp, or --with-apps for optional structures. Before delivery, run python3 scripts/validate_plugin.py <plugin-path>. The supplied material does not define an end-user trigger prompt.

What are this skill's strengths and limitations?

Pros
  • Generates the required manifest and plugin structure automatically.
  • Provides explicit defaults for plugin names, marketplace entries, and policy fields.
  • Supports personal marketplaces plus explicitly configured repository or team marketplaces.
  • Includes validation and local-plugin cache update scripts.
Limitations
  • No standalone skill-installation workflow is documented.
  • Requires Python 3 and local filesystem writes.
  • Targets Codex plugin packaging, so other platforms require adaptation.
  • The supplied material provides no test suite or cross-platform verification results.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Codex Plugin Builder this page ✓ OpenAI · Official 55 · Use with care ★ 129k 11d ago Apache-2.0
Codex Plugin Creator ✓ OpenAI · Official 43 · Not recommended ★ 28k 4mo ago —
Codex Issue Digest ✓ OpenAI · Official 57 · Use with care ★ 129k 11d ago Apache-2.0
Codex-Collab: Collaborate with Codex from Claude Code 56 · Use with care ★ 99 7d ago MIT
Claude Code Plugin Marketplace Template 56 · Use with care ★ 70 3mo ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
55/ 100 5-point scale 2.8 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust17 / 25 · 3.4/5

The skill scopes default writes to local plugin and personal-marketplace paths, requires confirmation for non-default marketplace writes, discourages unintended overwrite, and exposes --force; no malware, credential theft, or covert exfiltration is evident. Points are deducted because it directly writes to ~/plugins and ~/.agents/plugins/marketplace.json without transactional rollback, and it does not fully document sensitive-file handling, data flow, or external command side effects.

2Reliability7 / 20 · 1.8/5

The scripts, references, and validator are broadly consistent about naming, manifests, marketplaces, cachebusters, and readable error reporting. Points are deducted because static review cannot reproduce the key paths, no core-path test suite is shown, scaffold creation can leave partial state if marketplace updating fails, cachebuster writes are not atomic, and PyYAML availability is not explicitly documented.

3Adaptability10 / 15 · 3.3/5

Invocation scenarios, parameters, personal versus team marketplace boundaries, Windows path handling, and the update flow are relatively clear. Points are deducted for limited non-fit and compatibility guidance, no Chinese-language documentation or error messaging, and no file-level evidence that installation or updating is reachable from mainland-China networks; the core capability depends on a locally available Codex CLI.

4Convention11 / 15 · 3.7/5

The documentation uses quick start, workflow, reference specification, and validation sections, with substantial naming, defaults, schema, limitation, and update guidance; the repository supplies an Apache-2.0 license and verified OpenAI provenance. Points are deducted because skill-specific versioning policy, changelog, named maintenance responsibility, and explicit update channel are absent, while recovery examples for common failures are limited.

5Effectiveness6 / 15 · 2.0/5

The skill supplies direct scripts for scaffolding plugins, generating marketplace entries, updating cachebusters, and validating manifests, so the intended output should be directly usable and reduce manual editing errors. Points are deducted because this review is static and does not verify generated output, CLI compatibility, or representative execution; users may still need to resolve permissions, installation state, and cleanup after failures.

6Verifiability4 / 10 · 2.0/5

The committed Python implementations, validator, reference schemas, and command examples provide auditable primary evidence for limited static tracing. Points are deducted because no dedicated tests covering the skill's key paths or independent execution evidence is provided, so reproducibility and cross-source corroboration remain thin.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 19, 2026 Reviewed revision 678157acaa81 Review evidence[1][2][3][4][5][6][7][8][9][10][11][12][13][14][15][16][17][18]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does it cost anything?
The material states that the repository uses the Apache-2.0 License and does not mention an additional charge for this skill.
Where does it place generated plugins?
By default, plugins go under `~/plugins/<plugin-name>/`, while the personal marketplace file is `~/.agents/plugins/marketplace.json`.
Which files can it change?
It creates or updates `.codex-plugin/plugin.json` in the plugin directory and, when marketplace support is enabled, creates or updates the personal marketplace JSON file.
How are generation problems detected?
Run `python3 scripts/validate_plugin.py <plugin-path>` before delivery; the material does not specify detailed error messages or recovery behavior.

More skills from this repository

All from openai/codex

Dev & Engineering ✓ OpenAI · Official

Codex Issue Digest

Turns recent openai/codex bugs and enhancement requests into focused, owner-ready digests.

★ 129k FS 57 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex TUI Interactive Testing Guide

A focused workflow for launching Codex TUI and validating changes with trace logs.

★ 129k FS 37 Not recommended 11d ago
Design & Frontend ✓ OpenAI · Official

Codex Image Generation Skill (imagegen)

Generate or edit bitmap assets — photos, illustrations, textures, UI and product mockups — directly in Codex, with local transparent-background processing.

★ 129k FS 56 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

PR Babysitter

Continuously track a GitHub pull request’s reviews, CI, and mergeability while handling safe fixes.

★ 129k FS 57 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Bundled Skill Installer

Install curated or repository-hosted Codex skills without manually assembling their files and paths.

★ 129k FS 53 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

OpenAI Official Docs Assistant

Provides current, official-source guidance for OpenAI products, APIs, Codex, and model migrations.

★ 129k FS 52 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Pull Request Editor

Professionally update one or more GitHub pull request titles and bodies around motivation, net changes, and verification.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

V8 Version Maintainer

Updates Codex’s pinned V8 versions and validates release-candidate and build-failure paths.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Sample Skill Creator Guide

A practical guide to designing, validating, and refining reusable Agent Skills.

★ 129k FS 46 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Breaking Change Reviewer

Systematically detect compatibility risks across external integration surfaces before they reach users.

★ 129k FS 37 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Context Governance

Keep coding-agent context incremental, cache-stable, and strictly bounded.

★ 129k FS 35 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Review Agent Code Review Skill

Find actionable regressions in code changes through a read-only, defect-first review.

★ 129k FS 52 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Remote Executor Integration Tests

Validate Codex integration behavior across local and remote execution environments.

★ 129k FS 50 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Change Size Review Guide

Keep code changes reviewable by enforcing practical size limits and staging oversized work.

★ 129k FS 48 Use with care 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Path Types Guide

Choose Rust path types that preserve cross-platform URI handling and local filesystem behavior in Codex.

★ 129k FS 47 Use with care 11d ago
Automation & Ops ✓ OpenAI · Official

CI Push Approval Assistant

Handle CI configuration push blocks and approval handoffs

★ 129k FS 45 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Code Review and Testing Guidance

Helps coding agents choose and structure tests for logic changes.

★ 129k FS 43 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Codex Bug Triage Assistant

Determines whether an openai/codex GitHub bug should be verified, clarified, or explained as expected behavior.

★ 129k FS 40 Not recommended 11d ago
Dev & Engineering ✓ OpenAI · Official

Pull Request Code Review

Orchestrate a final pull request review and consolidate every actionable finding from specialized reviewers.

★ 129k FS 33 Not recommended 11d ago

Related skills