CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/judgment-list-author

Use when a team must create or refresh the human relevance judgments that search tests rely on, before running NDCG, MRR or recall evaluations: query sets, grading scales, rater guidelines, inter-rater agreement, Quepid, TREC-style pooling and refresh cadence.

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

Overview
Quality
Evals
Security
Files

Quality

Content

88%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 exceptionally actionable, well-sequenced workflow skill: concrete formats, executable code, explicit validation loops (kappa gate, staleness check), anti-patterns, and honest limitations. Token efficiency and file organization are good but not maximal — a small amount of background explanation and the all-inline structure (no reference files) leave slight room for improvement.

DimensionReasoningScore

Conciseness

The body is dense and operational — tier-sampling tables, grade anchors, refresh triggers — with little padding. Minor over-explanation could be trimmed: the Cohen's kappa formula "kappa = (p_o - p_e) / (1 - p_e)" and Wikipedia-quote scaffolding restate knowledge Claude already has, and the same Quepid API URL is cited inline four times before being repeated in References. This fits 'efficient; minor instances of over-explanation' (4) rather than the 'every token earns its place' anchor at 5, and is clearly above the 'some unnecessary explanation' anchor at 3.

4 / 5

Actionability

Guidance is fully executable and covers the common cases: a copy-paste-ready qrels file layout ("<topic_id> <iteration> <doc_id> <relevance>" with sample rows), a runnable sklearn kappa snippet, a runnable pooling function, the exact JSON output schema consumed by `elasticsearch-relevance-tests`, concrete spreadsheet columns for non-Quepid teams, and per-grade rater cues. This matches the anchor at 5; the Quepid UI steps ("Import queries (CSV or manual entry)") are procedural by nature and not a meaningful gap.

5 / 5

Workflow Clarity

Seven clearly sequenced steps (query set → scale → guidelines → Quepid → kappa → pooling → refresh) with explicit validation checkpoints and feedback loops: "kappa < 0.60 means your guidelines are ambiguous. Rewrite the edge-case section, run a calibration session, and re-judge the overlap set before proceeding", plus the Step 7 staleness check ("If the average exceeds 20%, schedule a re-judging session") and a trigger/action refresh table. This matches the anchor at 5 (explicit validation, error-recovery loops, checklists); the anchor at 4 would require missing or merely implicit checkpoints, which is not the case.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and all in-body references are to external URLs or sibling skills, so there is no nesting or broken-path risk; sections are well-organized with a clear References list. However, the ~300-line body keeps everything inline — the Quepid API field details, kappa threshold tables, and export-format specifics could live in a reference file to keep SKILL.md a leaner overview — so it fits 'good structure; most content appropriately placed; minor organization gaps' (4) rather than the 'content appropriately split' anchor at 5.

4 / 5

Total

18

/

20

Passed

Description

87%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 strong, focused description with an explicit 'Use when' trigger, concrete domain terms, and a clearly distinct niche in judgment-list authoring for search relevance testing. Its only weaknesses are minor: the capability list is noun-heavy rather than action-verb-driven, and a few natural synonyms (qrels, relevance ratings) are relegated to frontmatter keywords instead of the description.

DimensionReasoningScore

Specificity

The description names the domain and enumerates concrete deliverables — "query sets, grading scales, rater guidelines, inter-rater agreement, Quepid, TREC-style pooling and refresh cadence" — under the actions "create or refresh the human relevance judgments". It lists several specific items with only minor gaps (the enumerated items are topic nouns rather than distinct action verbs, which keeps it just below the comprehensive multi-action anchor at 5, but clearly above the '1-2 concrete actions' anchor at 3).

4 / 5

Completeness

It explicitly answers 'when' with a concrete trigger clause — "Use when a team must create or refresh the human relevance judgments that search tests rely on, before running NDCG, MRR or recall evaluations" — and 'what' with the enumerated deliverables. Both are explicit and concrete, matching the anchor at 5; the anchor at 4 requires a 'when' that 'could be more explicit or specific', which does not apply here.

5 / 5

Trigger Term Quality

Good keyword coverage of terms a practitioner would naturally say: "relevance judgments", "NDCG", "MRR", "recall", "grading scales", "Quepid", "pooling". A few natural synonyms are missing from the description itself — "qrels", "relevance ratings", "ground truth" (these appear only in frontmatter keywords) — which fits the 'good coverage, a few natural terms missing' anchor at 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and distinct — authoring/refreshing human relevance judgments (qrels) as the precursor to search metric evaluation — anchored by unique tools and terms ("Quepid", "TREC-style pooling", "inter-rater agreement"). Adjacent skills run the metrics; this one creates the corpus, so conflict risk is minimal, matching the anchor at 5 rather than the 'minor overlap risk with closely related skills' anchor at 4.

5 / 5

Total

18

/

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.

Reviewed

On this page