CtrlK
BlogDocsLog inGet started
Tessl Logo

create-code-review-lens

Author a review lens for Tessl Code Review, the reviewer skill that decides what a review looks for in a diff. Settles the review question and the bar a finding has to clear, drafts the lens, runs it against changes that should and should not trip it, backtests it against changes that already carry review feedback, and packages it as a pinned reference a workflow can select. Use when someone wants their code review to catch something it misses, to stop flagging something it should not, or to write, fork, tune, or debug a code review lens. Not for `tessl review` rubrics, which score skill quality rather than code.

83

1.29x
Quality

86%

Does it follow best practices?

Impact

96%

1.29x

Average score across 2 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

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

SKILL.md
Quality
Evals
Security

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 strong, well-structured skill that guides a complex multi-step creative process (authoring a code review lens) with clear sequencing, validation gates, and appropriate separation of concerns. Its main strength is the rigorous workflow with explicit testing and backtesting requirements before a lens can be considered finished. The primary weakness is that the core creative guidance (how to actually write a lens) is deferred to reference files that aren't available in the bundle, making it hard to fully assess actionability for the most critical step.

Suggestions

Include the referenced bundle files (references/lens-anatomy.md, references/validation.md) so the skill's progressive disclosure can be fully validated and the core lens-writing guidance is accessible.

Consider adding a minimal inline example of a lens SKILL.md snippet (even 10-15 lines) in step 3 so the skill is actionable without requiring the external reference for the most basic case.

DimensionReasoningScore

Conciseness

The skill is efficient and respects Claude's intelligence throughout. It avoids explaining basic concepts and focuses on what's unique to lens authoring. There are minor areas that could be tightened—e.g., the 'six facts' section has some redundancy with later procedural steps, and phrases like 'whatever it looks like on the page' add color but not information—but overall it's well-trimmed.

4 / 5

Actionability

The skill provides concrete CLI commands, a clear 6-step procedure, and specific diagnostic guidance for tuning. However, the actual lens-writing guidance is deferred to references (lens-anatomy.md, validation.md) that are not provided in the bundle, and there are no inline code examples of lens SKILL.md content. The commands shown are executable and specific, but the core creative act—writing the lens itself—relies on external files we cannot verify.

4 / 5

Workflow Clarity

The 6-step procedure is clearly sequenced with explicit validation checkpoints: step 4 requires running on positive and negative cases, step 5 requires backtesting with quantitative comparison, and the skill explicitly states 'A lens that has not been run is a draft' as a gate. The tuning section includes a diagnostic-before-editing loop with category-driven fixes and re-backtesting. The feedback loops for destructive/batch-like operations (publishing a lens that runs on everyone's code) are well-handled.

5 / 5

Progressive Disclosure

The skill appropriately references external files (references/lens-anatomy.md, references/validation.md) at the right points in the workflow, and defers detailed content to them rather than inlining it. References are one level deep and clearly signaled. However, no bundle files were provided, so we cannot verify these references exist or are well-structured. The skill itself is well-organized with clear sections and a separate tuning section for a distinct use case.

4 / 5

Total

17

/

20

Passed

Description

92%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 through multiple concrete actions, provides explicit 'Use when' guidance with natural trigger scenarios, and clearly distinguishes itself from related skills with an explicit exclusion boundary. The only minor weakness is that some trigger terms are domain-specific and could benefit from more generic synonyms users might naturally use.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: settles the review question, sets the bar a finding must clear, drafts the lens, runs it against positive/negative test changes, backtests against existing review feedback, and packages it as a pinned reference. This is comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Clearly answers both 'what' (author review lenses, draft, test, backtest, package them) and 'when' (explicit 'Use when' clause with concrete trigger scenarios: catching missed issues, stopping false positives, writing/forking/tuning/debugging lenses). Also includes a helpful exclusion boundary ('Not for tessl review rubrics').

5 / 5

Trigger Term Quality

Includes strong natural trigger terms like 'code review', 'lens', 'review lens', 'catch something it misses', 'stop flagging', 'write', 'fork', 'tune', 'debug'. However, some terms are domain-specific ('Tessl Code Review', 'pinned reference') and it could benefit from more generic synonyms like 'review rule', 'review check', or 'review criteria' that users might naturally say.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: authoring review lenses specifically for Tessl Code Review. The explicit boundary statement distinguishing it from 'tessl review rubrics' further reduces conflict risk. The domain-specific terminology ('review lens', 'Tessl Code Review') makes it unlikely to be confused with other skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tesslio/product-plugins
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.