CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 a clear Quick Start, concrete commands, exact JSON shapes, and a real one-level-deep reference bundle. Its main weaknesses are redundancy (duplicated marketplace JSON and repeated rules that cost tokens) and a slightly misdirected validation step that weakens the feedback loop.

Suggestions

Remove the duplicated marketplace entry JSON: show only the brand-new marketplace root example (which embeds the entry shape) and drop the standalone entry-shape block, saving ~15 lines of repeated spec detail.

State the ask-before-marketplace rule and the plugin-name normalization rules once (pick 'What this skill creates' or Quick Start) instead of repeating them in both sections.

Fix the validation step to target the scaffolded plugin output (e.g. validate the generated plugin.json and marketplace entry) and replace the unresolvable '<path-to-skill-creator>/scripts/quick_validate.py' placeholder with a concrete path, ideally with a note on what to do when validation fails.

DimensionReasoningScore

Conciseness

The body is rule-dense with no padding about concepts Claude already knows, but it is noticeably redundant: the full marketplace entry JSON appears twice (standalone entry shape and again inside the brand-new marketplace example), the ask-before-marketplace rule is stated twice (Quick Start step 3 and 'What this skill creates'), and naming rules repeat a Quick Start comment. This fits 'mostly efficient but could be tightened' (3) better than 'minor instances that could be trimmed' (4).

3 / 5

Actionability

Concrete, copy-paste-ready commands with real flags and example names ('python3 .agents/skills/plugin-creator/scripts/create_basic_plugin.py my-plugin --with-marketplace', full flag combos, exact JSON shapes, exact deeplink URL formats) cover the common cases. The gap keeping it below 5: the final validation command uses an unresolvable placeholder path '<path-to-skill-creator>/scripts/quick_validate.py' rather than a concrete location.

4 / 5

Workflow Clarity

The Quick Start is a clearly sequenced 1-4 workflow (scaffold, fill placeholders, marketplace entry, optional folders) with a final validation command, matching the 4 anchor. Not 5 because there is no error-recovery/feedback loop (what to do when validation fails), and the validation step is slightly misdirected ('After editing SKILL.md' rather than validating the scaffolded plugin); not 3 because sequence and checkpoints are largely present and appropriate.

4 / 5

Progressive Disclosure

The bundle structure is real and one level deep: the body references 'references/plugin-json-spec.md' (exists, contains the canonical spec) and the scaffold script 'scripts/create_basic_plugin.py' (exists), and the bulk spec detail is correctly deferred to the reference. Minor gaps keep it at 4: the reference is a bare code span rather than a clearly signaled link, and some spec detail (marketplace JSON shapes, policy enums) is inlined despite the reference covering it.

4 / 5

Total

15

/

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 description that clearly states concrete capabilities and explicit 'Use when' triggers with distinct, path-specific terminology. The only notable flaw is a second-person phrase ('placeholders you can edit'), which costs it a specificity point under the rubric's third-person rule.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with specific file paths ('Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`', 'generate or update personal or repo-root `.agents/plugins/marketplace.json` entries'), which matches the comprehensive 5 anchor; however 'baseline placeholders you can edit before publishing or testing' uses second-person voice, which the rubric penalizes by reducing specificity by 1.

4 / 5

Completeness

It explicitly answers both what ('Create and scaffold plugin directories ... with a required `.codex-plugin/plugin.json`, optional plugin folders/files, and baseline placeholders') and when ('Use when Codex needs to create a new personal plugin, add optional plugin structure, or generate or update ... marketplace.json entries') with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage including 'create a new personal plugin', 'add optional plugin structure', and 'marketplace.json' entries, but a few natural phrasings users might say (e.g. 'plugin marketplace', 'publish a plugin' as a trigger) are missing, so it fits the 4 anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Codex plugin scaffolding) with distinct triggers and unique file paths (`.codex-plugin/plugin.json`, `.agents/plugins/marketplace.json`) gives minimal conflict risk with other skills, matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.