plugin-creator

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body with concrete commands, clear sequencing, and a validation checkpoint, backed by real reference and script bundles. The main weakness is redundancy between the Marketplace workflow and Required behavior sections, plus some inlining that the spec reference already covers.

Suggestions

Consolidate the overlapping rules between 'Marketplace workflow' and 'Required behavior' (e.g. --marketplace-name usage, policy defaults, identifier validation) into a single authoritative section to reduce redundancy.

Move the two full inlined JSON samples and the allowed-value enumerations into references/plugin-json-spec.md, keeping only a minimal example inline and a clear pointer to the spec.

Add an explicit validate -> fix -> re-validate feedback loop in the Quick Start validation step rather than just instructing to run validate_plugin.py once.

Dimension	Reasoning	Score
Conciseness	Avoids explaining concepts Claude already knows and uses concrete commands, but the 'Marketplace workflow' and 'Required behavior' sections redundantly restate the same rules (--marketplace-name usage, validation, policy defaults), so it could be tightened.	3 / 5
Actionability	Fully executable, copy-paste-ready commands with specific flags appear throughout (create_basic_plugin.py, validate_plugin.py, update_plugin_cachebuster.py, read_marketplace_name.py) and cover the common scaffold/update cases.	5 / 5
Workflow Clarity	A clear numbered Quick Start sequence includes an explicit validation checkpoint (step 5) and 'stop if validation fails' guidance; validation is present so it is not capped at 3, but error-recovery feedback loops could be more explicit.	4 / 5
Progressive Disclosure	Real bundle files (references/plugin-json-spec.md, references/installing-and-updating.md, scripts/) are signaled one level deep and well organized, though two full JSON samples and the allowed-value lists are inlined despite a spec reference existing.	4 / 5
	Total	16 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that clearly states both what the skill does and when to use it, with concrete actions and a distinct niche. Minor jargon and a few missing synonyms keep trigger term quality and specificity just below perfect.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('Create and scaffold plugin directories', 'valid manifest defaults', 'personal-marketplace entries', 'generate or update marketplace entries', 'update an existing local plugin... cachebuster and reinstall flow') with comprehensive coverage, but some jargon keeps it just below a clean 5.	4 / 5
Completeness	Explicitly answers 'what' (scaffold plugin directories, manifest defaults, marketplace entries) and 'when' via a concrete 'Use when Codex needs to create a new personal plugin...' clause with multiple trigger phrases.	5 / 5
Trigger Term Quality	Natural terms like 'plugin', 'create a new personal plugin', 'marketplace entries', and 'update an existing local plugin' are present and would be said by users, but a few synonyms and file extensions are missing.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Codex plugin scaffolding/marketplace entries) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: openai/codex
Path: codex-rs/skills/src/assets/samples/plugin-creator/SKILL.md
Commit: 78245b4

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.