CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-copyable-snippets

Review a change to a code block a reader is meant to copy — a workflow, command, config file, or manifest embedded in documentation — for whether it works as printed. Use as one lens in a code review run.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 tight, instruction-only review-lens skill: every section is load-bearing, the method translates directly into concrete checks a reviewer can run, and the threshold/reporting sections close the loop. It is an exemplar of a compact single-purpose skill with no bundle overhead.

DimensionReasoningScore

Conciseness

The body is lean throughout: Scope, Method, Threshold, and Reporting each earn their tokens, no concept Claude already knows is re-explained, and even the edge-case paragraphs (external contracts, boundary with Skill Instruction Integrity) deliver non-obvious policy rather than padding. Matches anchor 5 ("every token earns its place") and sits above anchor 4 because there is nothing identifiable to trim.

5 / 5

Actionability

The Method gives concrete, executable probes for both artifact types — "resolve every expression ... and ask what the expression evaluates to when a field is absent" and "an unset variable, an empty match, and a path containing a space" — and Reporting specifies exact deliverables including "Give the corrected line". Per the rubric's code-vs-instruction note, the absence of code is not penalized because the guidance is fully actionable and covers the common cases.

5 / 5

Workflow Clarity

The flow (read blocks as runtime reads them → compare against prose → check for divergent copies → apply the Threshold gate → report) is unambiguous, and the Threshold section acts as an explicit include/exclude checkpoint with concrete exemptions. This is a read-only analysis skill, so the destructive/batch validation cap does not apply, and the simple-skill exception (under 50 lines, single task, clear) is satisfied.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed (no references/, scripts/, or assets/ bundles exist), and its four well-organized sections keep everything navigable inline. Per the rubric guideline, this scores 5 with just well-organized sections for a short single-file skill.

5 / 5

Total

20

/

20

Passed

Description

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

A specific, well-scoped description that names concrete targets and an explicit use context, held back from top marks only by its thin trigger-phrase coverage and terse when-clause. It reads as a genuine review lens rather than generic filler.

Suggestions

Add natural trigger synonyms such as "snippet", "copy-paste example", or "README command" to the description so users' phrasing matches more often.

Make the when-clause more concrete, e.g. "Use when a change touches commands, config blocks, or manifests embedded in documentation (READMEs, guides, templates)."

DimensionReasoningScore

Specificity

The description states a concrete action ("Review a change to a code block ... for whether it works as printed") and enumerates specific targets ("a workflow, command, config file, or manifest embedded in documentation"). It stops short of anchor 5 because the sub-checks the skill actually performs (divergent copies, unresolvable placeholders) are not surfaced, leaving minor gaps in coverage.

4 / 5

Completeness

The "what" is clear (review copyable embedded blocks for whether they work as printed) and an explicit use clause exists ("Use as one lens in a code review run"). Not 5 because the when-clause is terse and lacks concrete trigger phrases (e.g., when a change touches embedded commands or config blocks in docs); not 3 because an explicit use clause is present, so the missing-when cap does not apply.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "code block", "copy", "documentation", "config file", "manifest", "command", "code review". It falls below anchor 5 because common synonyms a user would naturally say — "snippet", "example", "copy-paste" — are absent, but it is well above anchor 3's single-keyword level.

4 / 5

Distinctiveness Conflict Risk

Clear niche (copy-paste-able blocks embedded in documentation) that is largely distinct, but "Use as one lens in a code review run" overlaps with general code-review skills, creating minor conflict risk on generic "review my PR" triggers.

4 / 5

Total

16

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tesslio/product-plugins

Path

review-lenses/review-copyable-snippets/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.