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

90%

Does it follow best practices?

Impact

95%

1.31x

Average score across 6 eval scenarios

Securityby

Critical

Do not install without reviewing

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

Quality

Content

81%Scale 1-5

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

This is a well-crafted skill with excellent actionability and workflow clarity. Every step has concrete, executable commands and the validation step includes specific success criteria and a comprehensive troubleshooting table. The main weakness is moderate verbosity — some explanatory prose could be trimmed without losing clarity, particularly the introductory sections and the default rubric explanation.

Suggestions

Trim the introductory paragraphs and 'The default rubric' section — the tables and config examples already convey the structure; the prose restates what the config.json and rubric files show directly.

Dimension	Reasoning	Score
Conciseness	The skill is reasonably efficient for its complexity but includes some unnecessary explanation (e.g., explaining what a reviewer plugin is, what 'good' means). The tables and examples are useful but the prose around them could be tighter. Some sections like 'The default rubric' explain things Claude could infer from the config structure.	3 / 5
Actionability	Highly actionable with copy-paste ready bash commands for every step, concrete JSON templates for rubric files and config, specific curl commands for fetching defaults, and exact tessl CLI invocations for validation. The minimal rubric template is complete and executable.	5 / 5
Workflow Clarity	Clear 6-step sequence with explicit validation in Step 6 including specific success criteria (overallPassed: true, judges map, reviewScore 0-100). Error recovery is well-handled via the common problems table with cause-fix pairs. The fork vs scratch paths are clearly delineated with explicit branching instructions.	5 / 5
Progressive Disclosure	Good structure with clear sections, numbered steps, and two distinct paths (A/B). The content is well-organized with tables for quick reference. However, no bundle files are provided despite the skill being moderately long (~200 lines), and the minimal rubric template could potentially live in a reference file. The inline content length is reasonable for a single SKILL.md though.	4 / 5
	Total	17 / 20 Passed

Description

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

This is an excellent skill description that comprehensively covers what the skill does with multiple concrete actions, provides explicit trigger guidance via a 'Use when...' clause with varied natural terms, and occupies a clearly distinct niche. It uses proper third-person voice throughout and balances detail with conciseness.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: fetches the published default rubric, scaffolds the plugin directory, writes rubric files and config.json, validates with tessl review run. Comprehensive coverage of the workflow.	5 / 5
Completeness	Clearly answers both 'what' (scaffold and author a custom Tessl reviewer plugin, fetch default rubric, scaffold directory, write files, validate) and 'when' with an explicit 'Use when...' clause listing concrete trigger scenarios like creating/customising a review plugin, forking the rubric, changing weights, adding judges, or building domain-specific rubrics.	5 / 5
Trigger Term Quality	Includes rich natural trigger terms: 'review plugin', 'fork', 'tweak', 'default reviewer rubric', 'scoring weights', 'custom judges', 'domain-specific rubric', 'tessl review', 'customise', 'scaffold'. These cover a wide range of natural phrases a user would say.	5 / 5
Distinctiveness Conflict Risk	Highly distinctive with a clear niche: Tessl reviewer plugin creation and customization. The specific tool name 'tessl', specific artifacts like 'config.json', 'rubric files', and specific commands like 'tessl review run' make this very unlikely to conflict with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: tesslio/product-plugins
Path: review-plugin-creator/skills/create-review-plugin/SKILL.md
Commit: 37f0a21

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.