Content
78%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, largely self-contained instruction skill with a clearly sequenced workflow and concrete file/field specifics. The main improvements are deduplicating the repeated default-path rule and adding example manifest snippets plus an error-recovery step for failed validations.
Suggestions
State the default output path once (Output Location) and reference it elsewhere as 'the default path' — it currently appears verbatim four times, which costs tokens without adding information.
Add a minimal example plugin.json (and marketplace.json entry) so the manifest shape is copy-paste ready instead of inferred from the field list.
Extend the validation steps (name format, manifest paths) with a brief fix-and-retry instruction so the workflow has an explicit feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no concept explanations, just paths, file names, and field lists. The one trimmable redundancy is the default path '~/.cursor/plugins/local/<plugin-name>/' repeated four times (Output Location, Workflow step 2, Guardrails, Output), which keeps it at anchor 4 rather than 5. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact directory paths, required frontmatter fields per component type ('Rules: .mdc with description, alwaysApply, optional globs', 'commands/*.(md|txt)'), and a manifest field list. It falls short of anchor 5 only because no example plugin.json or marketplace.json snippet is given, so the manifest shape must be inferred. | 4 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation checkpoints: step 1 validates the name format, step 7 validates manifest paths, and the Output section requires a validation report of required fields and component metadata. It misses anchor 5 because there is no error-recovery feedback loop (e.g., what to do when name or path validation fails). | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are needed — the skill is a single self-contained document with well-organized, clearly headed sections (Trigger, Required Inputs, Output Location, Workflow, Guardrails, Output) and no inlined bulk that belongs in a separate file. All navigation is one page, so nothing is buried and there are no nested references. | 5 / 5 |
Total | 17 / 20 Passed |