CtrlK
BlogDocsLog inGet started
Tessl Logo

plugin-creator

Scaffold Codex plugin packages with deterministic manifests, marketplace metadata, and traceability or evidence contracts for non-trivial adoption. Use when creating plugin roots or adopting existing skills into plugin ownership.

46

Quality

48%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./Plugins/plugin-factory/fixtures/budget-archive/2026-04-21/deferred-store/skills/scaffolding_templates/plugin-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

59%

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 has good structural completeness with an explicit 'Use when' clause and targets a clearly distinct niche. However, it relies heavily on specialized jargon that most users would not naturally use, reducing its effectiveness as a trigger-matching description. The capabilities described are somewhat abstract rather than listing concrete, understandable actions.

Suggestions

Replace jargon with plain-language equivalents or add them alongside: e.g., 'deterministic manifests' → 'plugin manifest files (plugin.json)', 'evidence contracts' → 'validation/test contracts'.

Add natural trigger terms users might actually say, such as 'create a new plugin', 'initialize plugin project', 'plugin boilerplate', 'plugin template', or 'package a skill as a plugin'.

DimensionReasoningScore

Specificity

It names a domain (Codex plugin packages) and some actions (scaffold, create manifests, marketplace metadata, traceability contracts), but the language is heavy on jargon ('deterministic manifests', 'evidence contracts for non-trivial adoption') rather than concrete, easily understood actions like 'create config files' or 'generate package.json'.

2 / 3

Completeness

It does answer both 'what' (scaffold Codex plugin packages with manifests, metadata, and contracts) and 'when' ('Use when creating plugin roots or adopting existing skills into plugin ownership'), with an explicit 'Use when...' clause providing trigger guidance.

3 / 3

Trigger Term Quality

The terms used ('deterministic manifests', 'traceability or evidence contracts', 'non-trivial adoption') are highly specialized jargon that users would almost never naturally say. Common terms like 'plugin', 'scaffold', or 'package' are present but buried among opaque terminology. Missing natural variations users might say.

1 / 3

Distinctiveness Conflict Risk

The description targets a very specific niche—Codex plugin package scaffolding with particular artifacts—making it highly unlikely to conflict with other skills. The domain is narrow and well-defined.

3 / 3

Total

9

/

12

Passed

Implementation

37%

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

This skill has reasonable structure and clear boundaries/constraints, but it delegates nearly all actionable workflow content to external references while providing no inline scaffold steps, directory layout, or manifest schema. The duplicated context-disposition paragraph and several low-value sections (Remember, Core Philosophy) waste tokens. The skill would benefit significantly from an inline minimal workflow with validation checkpoints and a concrete example of the expected plugin directory structure and manifest.

Suggestions

Add an inline minimal workflow with numbered steps showing the actual scaffold creation process (directory creation, manifest generation, validation), rather than deferring entirely to references/workflow.md.

Include a concrete example of the expected plugin directory structure and a minimal plugin.json manifest schema so Claude knows exactly what to produce.

Remove the duplicated 'context-disposition policy' paragraph and trim low-signal sections like 'Core Philosophy' and 'Remember' to improve token efficiency.

Add explicit validation checkpoints within the workflow (e.g., validate manifest schema before marketplace wiring) to create feedback loops for error recovery.

DimensionReasoningScore

Conciseness

The skill has some unnecessary repetition (the context-disposition policy paragraph is duplicated verbatim) and includes sections like 'Remember' and 'Core Philosophy' that add little actionable value. However, it's mostly structured and doesn't over-explain basic concepts.

2 / 3

Actionability

The skill provides concrete examples of user requests and validation commands, but the actual scaffold procedure is deferred entirely to references/workflow.md. The main body lacks executable code or step-by-step instructions for creating the plugin structure, manifest JSON schema, or directory layout. The examples section shows prompts but not expected outputs or concrete file structures.

2 / 3

Workflow Clarity

The workflow section simply says 'Use the detailed scaffold procedure in references/workflow.md' without providing any inline steps, sequencing, or validation checkpoints. For a skill involving file creation, moves, and manifest validation, the absence of any visible workflow with feedback loops is a significant gap. The validation section has commands but no integration into a sequenced workflow.

1 / 3

Progressive Disclosure

References are clearly listed and mostly one level deep with descriptive labels for when to read them. However, since no bundle files were provided, we cannot verify the references exist. The 'Read when' section is well-structured, but the main body defers too much core content to references, leaving the SKILL.md itself thin on actionable guidance. The duplicated paragraph also hurts organization.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
jscraik/Agent-Skills
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.