plugin-creator

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, and baseline placeholders you can edit before publishing or testing. Use when Codex needs to create a new personal plugin, add optional plugin structure, or generate or update personal or repo-root `.agents/plugins/marketplace.json` entries for plugin ordering and availability metadata.

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.

The body is highly actionable with executable commands and a clear quick-start sequence, supported by a real reference file and script. The main weakness is repetition across sections and partial duplication between inline JSON and the referenced spec, which inflates token cost without adding clarity.

Suggestions

Consolidate the duplicated "ask which marketplace to update when a repo marketplace.json exists" guidance into a single section instead of restating it in Quick Start and What this skill creates.

Replace the two overlapping marketplace JSON samples (entry shape and brand-new root) with one canonical example and defer full detail to references/plugin-json-spec.md to reduce redundancy.

Add an explicit validate->fix->retry feedback loop for the scaffolded plugin output (not just SKILL.md editing) so destructive/overwrite cases have a clear checkpoint before the final Codex handoff.

Dimension	Reasoning	Score
Conciseness	Mostly directive and bullet-driven without explaining known concepts, but several points are restated across sections (e.g., the repo-marketplace "ask first" guidance appears in both Quick Start and What this skill creates) and the two marketplace JSON blocks overlap, so it could be tightened.	3 / 5
Actionability	Provides fully executable, copy-paste-ready commands with concrete flag combinations and complete JSON samples covering the common personal- and repo-marketplace cases.	5 / 5
Workflow Clarity	Quick Start is clearly sequenced (steps 1-4) and includes a validation command, but the feedback loop is only stated for SKILL.md editing rather than for the scaffolded plugin output, leaving minor checkpoint gaps.	4 / 5
Progressive Disclosure	Well-organized into labeled sections with a clearly signaled one-level-deep reference (references/plugin-json-spec.md) and the scaffold script, though some canonical JSON detail is duplicated inline rather than deferred to the reference file.	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.

The description is third-person, concrete, and explicitly pairs capabilities with a well-scoped "Use when" trigger clause. Minor specificity gaps around publishing/testing keep it just short of maximal concreteness.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ("Create and scaffold plugin directories", "required `.codex-plugin/plugin.json`", "optional plugin folders/files", "baseline placeholders you can edit") but "publishing or testing" is somewhat generic, leaving minor coverage gaps versus the comprehensive anchor.	4 / 5
Completeness	Explicitly states both what (scaffold plugin dirs with plugin.json, optional folders, placeholders) and when via a concrete "Use when ..." clause with multiple trigger conditions.	5 / 5
Trigger Term Quality	Includes natural trigger phrases ("create a new personal plugin", "add optional plugin structure", "generate or update ... marketplace.json entries") with good keyword coverage, though a few common synonyms are absent.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Codex plugin scaffolding) with distinct triggers like `.codex-plugin/plugin.json` and `marketplace.json`, minimizing overlap 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/plugins
Path: .agents/skills/plugin-creator/SKILL.md
Commit: 1e28582

Reviewed: 7 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.