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

86%

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

72%Weight 40%Scale 1-3

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

The skill body is highly actionable with executable commands and a well-organized, one-level-deep reference structure. It loses points on conciseness from duplicated guidance and on workflow clarity because validation/feedback checkpoints are not interleaved across the branching marketplace-creation flow.

Suggestions

Remove the duplicated 'ask personal vs team before generating a marketplace entry' rule and the repeated marketplace entry JSON shape, keeping each in one canonical place to tighten conciseness.

Add explicit validation checkpoints between workflow steps (e.g. verify plugin.json placeholders were filled before generating the marketplace entry, and confirm --force is intentional before overwriting an existing entry) to lift workflow clarity.

Consolidate the two marketplace JSON samples (inline entry shape and full root object) into a single clearly-labeled example or move one into references/plugin-json-spec.md.

Dimension	Reasoning	Score
Conciseness	The body is largely efficient and assumes Claude's competence, but repeats guidance (the 'ask personal vs team' rule appears in both Quick Start and 'What this skill creates', and the marketplace entry JSON shape is shown twice), so it is mostly efficient but could be tightened; it is not score 3 due to this redundancy and not score 1 because there is no padding with concepts Claude already knows.	2 / 3
Actionability	Provides fully executable commands with complete flag sets (e.g. 'python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py my-plugin --with-skills --with-hooks ...'), copy-paste JSON shapes, and concrete naming-normalization examples, matching the anchor for copy-paste-ready guidance.	3 / 3
Workflow Clarity	Quick Start gives a numbered scaffold->edit->marketplace->optional-folders sequence with a final validation step, but validation checkpoints are terminal rather than interleaved and the --force overwrite path is only loosely gated, so per the rubric feedback-loop guidance for destructive/batch operations workflow clarity is capped at 2; it is not score 1 because steps are clearly listed and sequenced.	2 / 3
Progressive Disclosure	Content is split into clear sections (Quick Start, What this skill creates, Marketplace workflow, Required behavior, Reference to exact spec sample, Validation) with a single one-level-deep reference to references/plugin-json-spec.md that exists as a real file; it is not score 2 because navigation is clearly signaled and the canonical spec is appropriately offloaded rather than inlined.	3 / 3
	Total	10 / 12 Passed

Description

100%Weight 40%Scale 1-3

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 specific, complete, and distinctive, with an explicit 'Use when' trigger clause and concrete capabilities. It uses third-person voice and avoids vague fluff, capping at the top of the scale.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions such as 'Create and scaffold plugin directories', 'required `.codex-plugin/plugin.json`', 'optional plugin folders/files', and 'baseline placeholders you can edit', matching the anchor for multiple specific concrete actions.	3 / 3
Completeness	It explicitly answers both what ('Create and scaffold plugin directories...') and when via an explicit 'Use when Codex needs to create a new personal plugin...' clause, satisfying the top anchor for both what AND when.	3 / 3
Trigger Term Quality	Natural phrases a user would say are present ('create a new personal plugin', 'add optional plugin structure', 'generate or update...marketplace.json entries'), giving good coverage; it is not score 2 because it goes beyond a single keyword to several realistic trigger phrasings.	3 / 3
Distinctiveness Conflict Risk	Targets a clear niche (Codex plugin scaffolding with manifest and marketplace entries) with distinct triggers, making it unlikely to fire for unrelated skills; it is not score 2 because the scope is sharply bounded rather than broadly overlapping.	3 / 3
	Total	12 / 12 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: 11c74d6

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