CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/review-plugin-creator

Guided workflow for creating a custom Tessl reviewer plugin, by forking the default rubric or building one from scratch. Scaffolds the plugin directory structure, authors rubrics and config.json, and validates the result with tessl review run.

95

1.49x
Quality

93%

Does it follow best practices?

Impact

100%

1.49x

Average score across 4 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

85%

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

Strong, actionable skill body with clear workflows, executable code, and well-structured progressive disclosure. The only weakness is moderate verbosity in framing paragraphs that could be tightened without losing clarity.

Suggestions

Tighten the opening paragraph and remove explanations that restate what Claude already knows about plugins and rubrics to improve conciseness.

Consider moving the 'Common problems' table to a reference file if the main body needs to be shorter.

DimensionReasoningScore

Conciseness

The body is ~275 lines with generally efficient content, but includes some unnecessary framing (e.g., explaining what a reviewer plugin is, restating that schemas should not be modified). The tables and code blocks earn their space, but several paragraphs could be tightened.

2 / 3

Actionability

Provides executable bash commands for every step, complete JSON templates for rubric files and config, specific file paths, and a concrete validation command with expected output fields. Copy-paste ready throughout.

3 / 3

Workflow Clarity

Clear 6-step process with two well-differentiated paths (Fork vs Scratch). Step 6 is an explicit validation checkpoint with expected output. The 'Common problems' table provides error recovery. The weight invariant is stated and reinforced at each relevant step.

3 / 3

Progressive Disclosure

Well-organized sections with the main skill as overview. Default rubric files are correctly referenced in references/default-rubric/ (verified to exist). Schemas are in references/schemas/. The reviewer-SKILL.md is a separate reference file. No deeply nested references; all one level deep.

3 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

Excellent description that clearly states concrete capabilities, provides natural trigger terms covering common user phrasings, and explicitly answers both what and when. The niche is distinct enough to avoid activation conflicts.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'Scaffold and author a custom Tessl reviewer plugin', 'forking the default rubric or building one from scratch', 'scaffolds the plugin directory', 'writes rubric files and config.json', 'validates with tessl review run'.

3 / 3

Completeness

Clearly answers both what ('Scaffold and author a custom Tessl reviewer plugin') and when ('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').

3 / 3

Trigger Term Quality

Strong coverage of natural terms: 'review plugin', 'reviewer plugin', 'rubric', 'scoring weights', 'custom judges', 'domain-specific rubric', 'tessl review', 'fork', 'tweak'. These match what a user would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly specific niche: creating reviewer plugins for tessl review. The domain-specific terminology ('reviewer plugin', 'rubric', 'tessl review') makes conflicts with other skills very unlikely.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

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

Warning

Total

15

/

16

Passed

Reviewed

Table of Contents