CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-review-plugin

Scaffold and author a custom Tessl reviewer plugin, by forking the default rubric or building one from scratch. Fetches the published default Tessl review rubric (tessl/default-skill-review) so you can read and tweak it, scaffolds the plugin directory, writes rubric files and config.json, and validates with tessl review run. Use when the user wants to create or customise a review plugin, fork or tweak the default reviewer rubric, change scoring weights, add custom judges, or build a domain-specific rubric for tessl review.

1.31x
Quality

97%

Does it follow best practices?

Impact

95%

1.31x

Average score across 6 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is tessl/review-plugin-creator

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 high-quality instruction body: fully executable commands, a clearly sequenced fork-or-scratch workflow with an explicit validation feedback loop and error-recovery table, and no filler. The only minor gap is progressive disclosure — the long inline rubric template could be split into a reference file, which is what separates it from a perfect score.

Suggestions

Move the minimal rubric JSON template (Step 4, Path B) into a one-level-deep reference file (e.g. references/rubric-template.json) and link to it, trimming the inline body.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no space is spent explaining what Tessl, rubrics, or plugins are; every section (tables of weights, bash scaffolding blocks, the rubric template) is load-bearing instruction. It matches the 'every token earns its place' anchor rather than the level below, where trimming would still be needed.

5 / 5

Actionability

Guidance is copy-paste executable throughout: the mkdir/curl/cp scaffold commands, heredoc-quoted plugin.json and config.json writers, a complete minimal rubric JSON template, the exact 'tessl review run' validation command, and a healthy-output checklist. It fully matches the 'copy-paste ready, covers the common cases' anchor.

5 / 5

Workflow Clarity

Six clearly sequenced steps with decision points up front (fork vs scratch, judge count/weights with an explicit weight invariant), an explicit validation step (Step 6) with expected healthy output, and a feedback loop: 'If the plugin fails validation... Fix the relevant file and re-run', backed by a Common problems table for error recovery. This matches the top anchor with validation checkpoints and error-recovery loops.

5 / 5

Progressive Disclosure

The single-file body is well organized with clear sections, and it correctly points to the canonical default rubric via an on-demand fetch instead of bundling a copy. However, the ~45-line inline rubric JSON template (and to a lesser extent the SKILL.md-customisation guidance) is content that could live in a one-level-deep reference file for a skill of this length, so it fits the 'good structure, minor organization gaps' anchor rather than the perfectly-split top anchor. Not a 3 because nothing is buried: every section is clearly signaled and nothing belongs to a second-level reference.

4 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: concrete third-person action list, an explicit 'Use when' clause with natural trigger phrases and synonyms, and a clearly delimited niche. All four dimensions sit at the top anchors with no anti-drift adjustment needed.

DimensionReasoningScore

Specificity

The description enumerates concrete, specific actions — 'scaffolds the plugin directory, writes rubric files and config.json, and validates with tessl review run' — comprehensively covering the full workflow (scaffold, author via fork or scratch, write, validate). It stays in third person ('Fetches', 'scaffolds', 'validates'), so no voice penalty applies.

5 / 5

Completeness

It explicitly answers both questions: 'what' ('Scaffold and author a custom Tessl reviewer plugin, by forking the default rubric or building one from scratch... validates with tessl review run') and 'when' with a literal 'Use when the user wants to...' clause listing concrete triggers — matching the score-5 anchor exactly.

5 / 5

Trigger Term Quality

The 'Use when' clause covers the natural phrases a user would actually say: 'create or customise a review plugin', 'fork or tweak the default reviewer rubric', 'change scoring weights', 'add custom judges', 'build a domain-specific rubric', plus the product trigger 'tessl review'. Synonyms are included (create/customise, fork/tweak), matching the comprehensive-coverage anchor; there is no natural term missing for this domain.

5 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped to Tessl reviewer plugins with distinct trigger vocabulary ('reviewer rubric', 'scoring weights', 'custom judges', 'tessl review'), so it is unlikely to fire for unrelated plugin- or rubric-related requests. Not the level below (4) because there is no meaningful overlap with closely related skills.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

tesslio/product-plugins

Path

review-plugin-creator/skills/create-review-plugin/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.