CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

best-of-n

Generate bounded independent candidates, score them against a frozen rubric, and verify the selected result with a proof log.

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./examples/skills/best-of-n/SKILL.md
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.

The body is an exemplar of a lean protocol skill: a clear use/not-use trigger, an input contract with an early exit, a sequenced procedure with built-in verification and escalation paths, hard guardrails against motivated stopping, and a concrete output record. The only notable gap is that the proof-log format and full method live in external files not present in the bundle, which slightly limits standalone executability.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — 'Do not reveal candidate text, scores, or private reasoning across generators. Assign an opaque identifier to every generated candidate.' — with zero explanations of concepts Claude already knows and no padded passages. Every line instructs or constrains, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Concrete, executable guidance dominates: exact return values ('return needs_contract', 'PASS, FAIL, or UNKNOWN'), a copy-paste BEST-OF-N RESULT output template, and specific mechanics like isolated worktrees 'from the same base revision' and capturing 'commands, output location, exit status, artifact hash or revision'. Not 5 because the full method and the proof-log template are delegated to external files outside the skill bundle, so a reader must chase those to fully execute.

4 / 5

Workflow Clarity

The eight-step procedure is clearly sequenced with explicit validation checkpoints and feedback loops: contract freezing before generation, the needs_contract early exit, executable checks with recorded exit status, reviewer escalation 'If executable verification cannot decide the requirement', and UNKNOWN blocking verified claims. An input checklist and a guardrails section round out a full error-recovery loop.

5 / 5

Progressive Disclosure

The ~50-line body is well organized into focused sections and appropriately delegates detail through clearly signaled one-level-deep links: 'Read the full method at [Best-of-N: Generate, Select, and Verify]', the TESTING.md proof-log template, and a Connections section of related guides. There is no inlined content that belongs in a separate file.

5 / 5

Total

19

/

20

Passed

Description

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

The description clearly states what the skill does with three concrete actions, but omits any 'when to use' trigger guidance and leans on process jargon rather than natural user phrasing. It is serviceable but under-triggered in practice because a user asking to 'try a few approaches and pick the best' would not naturally match this text.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when a task has several plausible solutions, a wrong choice is costly, and a deterministic check or independent reviewer can verify the result.'

Include natural trigger terms users would actually say, such as 'best-of-N', 'generate multiple options', 'try several approaches', or 'pick the best solution'.

State the selection step explicitly (e.g. 'select the highest-scoring candidate') rather than only implying it via 'the selected result'.

DimensionReasoningScore

Specificity

The description lists three concrete third-person actions — 'Generate bounded independent candidates, score them against a frozen rubric, and verify the selected result with a proof log' — matching the several-specific-actions anchor. It is not 5 because coverage is not comprehensive: the selection step is only implied by 'the selected result', and no candidate-count or batching capability is named.

4 / 5

Completeness

The 'what' is clearly stated (generate, score, verify), but there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because nothing in the description states when to use the skill.

3 / 5

Trigger Term Quality

Keywords like 'candidates', 'score', 'rubric', 'verify', and 'proof log' are relevant but jargon-leaning, and the natural phrases a user would say ('best-of-N', 'multiple options', 'try several approaches', 'pick the best') are absent. Not 4 because the common variations and synonyms are missing entirely, not just a few.

3 / 5

Distinctiveness Conflict Risk

The bounded-candidate generation plus frozen-rubric scoring plus proof-log verification niche is mostly distinct, with only minor overlap risk against general evaluation or code-review skills. Not 5 because the description lacks explicit distinct trigger phrases that would fully separate it from those related skills.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 7 suspicious

Warning

Total

14

/

16

Passed

Repository

FlorianBruniaux/claude-code-ultimate-guide

Path

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