CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-of

This skill should be used when the user asks to "compare code", "compare worktrees", "compare solutions", "which solution is better", "compare branches", "best of", "diff worktrees", "evaluate solutions", "pick the better implementation", "compare implementations", "review both solutions", or wants a structured, criteria-driven comparison of code across two git worktrees. Also triggered by the /best-of command.

Quality

87%

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

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

An exemplarily operational skill: executable commands at every step, explicit validation checkpoints, ready-to-dispatch agent prompts, a defined scoring model, and a complete output template, with criteria detail correctly pushed to a real one-level-deep reference file. The only flaw is mild redundancy in the repeated agent-prompt boilerplate and duplicated scorecard presentation.

DimensionReasoningScore

Conciseness

The body is efficient — real commands, no explanations of concepts Claude already knows, no padded prose — matching anchor 4 rather than 5. The three agent prompts each repeat ~6 identical boilerplate lines ("You are reviewing two code solutions side by side... Worktree A/B... Files to compare... Project rules"), and the scorecard table appears in both Step 5 and the Step 6 output template, which could be tightened.

4 / 5

Actionability

Fully executable throughout: concrete git commands (merge-base computation, diff --name-only, diff -rq with a head -200 guard), copy-paste-ready agent prompts with explicit fill-in placeholders, a concrete 3x/2x/1x weighting table, and a complete output template. Not 4 because there are no meaningful gaps — the common cases are covered with specific commands.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation: Step 1 validates both worktree paths with a failure branch ("If either path is invalid, report the error and stop") and asks the user for missing paths; Step 3 warns on truncated file lists and suggests narrowing scope; Steps 2 and 5 use checklists (Project Rules Checklist, 15-criterion scorecard); the Proportional constraint scales depth to diff size. This matches anchor 5 — the skill is read-only so destructive-batch caps do not apply.

5 / 5

Progressive Disclosure

Scored against the actual bundle: the single reference (references/evaluation-criteria.md) exists, is one level deep, and is clearly signaled in both Step 5 ("see references/evaluation-criteria.md") and the Additional Resources section. The 15-criteria scoring detail is appropriately deferred to it while the body keeps only the workflow, matching the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

19

/

20

Passed

Description

77%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 trigger-rich description with excellent natural-language phrasing and a clearly explicit use-when clause, anchored on a distinct two-worktree comparison niche. Its weakness is the "what": a single abstract clause that never enumerates the concrete outputs (criteria-based scoring, weighted verdict, compliance findings) the skill actually produces.

Suggestions

State the concrete outcome in the description, e.g. append 'produces a weighted scorecard across 15 engineering criteria and an evidence-based verdict on which solution is better' — this raises both specificity and completeness.

Trim overlapping trigger phrases (e.g. keep one of 'compare solutions'/'evaluate solutions'/'review both solutions') and spend the saved words on what the skill does.

Drop or de-emphasize the very broad trigger 'compare code', which risks firing for ordinary single-branch code reviews that this skill is not designed for.

DimensionReasoningScore

Specificity

The description names the domain and a single action framing — "a structured, criteria-driven comparison of code across two git worktrees" — but lists no concrete capabilities (scoring, verdict, criteria evaluation). It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is not 4 because it does not enumerate several specific actions, and not 2 because the comparison framing is concrete rather than generic.

3 / 5

Completeness

Both "what" ("structured, criteria-driven comparison of code across two git worktrees") and a very explicit "when" (the long trigger list) are present, matching anchor 4. It falls short of 5 because the "what" is one abstract clause — it never states concrete outcomes like producing a weighted scorecard or an evidence-based verdict.

4 / 5

Trigger Term Quality

Eleven quoted natural trigger phrases with genuine synonym coverage — "compare code", "compare worktrees", "diff worktrees", "best of", "which solution is better", "pick the better implementation", "evaluate solutions" — plus the /best-of command. These are phrases a user would naturally say, matching the comprehensive anchor; there are no missing common variations.

5 / 5

Distinctiveness Conflict Risk

The two-worktree comparison niche is clear and most triggers ("compare worktrees", "diff worktrees", "best of") are distinct, matching anchor 4. It is not 5 because broad phrases like "compare code", "evaluate solutions", and "review both solutions" could plausibly match a generic code-review skill.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

pmatos/skills

Path

best-of/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.