CtrlK
BlogDocsLog inGet started
Tessl Logo

clinvar-database

Use when needing clinical significance, pathogenicity classifications (e.g., Pathogenic, Benign, VUS), clinical evidence rationales, or finding "hard positive" benchmark controls for human genomic variants.

63

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/clinvar_database/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-organized, highly actionable skill body with executable commands and complete output schemas, weakened by redundancy (API-key instructions repeated), a self-contradictory retmax rule, and an unreferenced bundle file. The core guidance is strong; tightening and reconciling the retmax statements would lift the lower dimensions.

Suggestions

Reconcile the retmax guidance: the script defaults to 0 (fetch all), so remove or correct the 'defaults to --retmax 200 / MUST set higher' text in Core Rules to avoid contradicting the script.

Consolidate the NCBI_API_KEY / credentials instructions into one place (e.g., Prerequisites) and reference it from Core Rules and the dedicated section rather than repeating the full paragraph.

Link references/citation.bib from the body (e.g., under a Citations section) so the existing bundle file is discoverable rather than orphaned.

DimensionReasoningScore

Conciseness

The body is mostly efficient — command examples, argument lists, and output schemas are all directly useful with no padding of concepts Claude already knows — but it repeats the NCBI_API_KEY/credentials instructions in three places (Prerequisites, Core Rules, and a dedicated section) and carries a self-contradictory retmax statement. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 3 due to the repetition and contradiction, not 1 because there is no concept-explaining fluff.

2 / 3

Actionability

Every command is given as a fully executable `uv run scripts/clinvar_api.py ...` invocation with complete argument lists, concrete output JSON schemas (field names and types), and per-command examples that match the actual script. This matches the 'fully executable code/commands; copy-paste ready' anchor and is not 2 (no pseudocode or missing key details).

3 / 3

Workflow Clarity

Workflows (Count-First, search→evidence, triangulation) are clearly sequenced and include a verification checkpoint ('verify total_count and fetched_count match'), but the 'Core Rules' retmax guidance ('defaults to --retmax 200', 'MUST set higher') contradicts the script's actual default (0 = fetch all), creating a real ambiguity for batch 'List all' operations, and the mandatory coordinate rule lacks a complete verify loop for the dbSNP fallback. This fits 'steps listed but validation gaps'; not 3 because of the contradiction, not 1 because sequences and some checkpoints are present.

2 / 3

Progressive Disclosure

Content is organized into clear sections and the one script reference (scripts/clinvar_api.py) is real and one level deep, but the four command references are inlined as a large block that could live in a separate file, and references/citation.bib exists in the bundle yet is never linked or signaled from the body. This matches 'some structure; references present but not clearly signaled; content that should be separate is inline'; not 3 (unreferenced bundle file, large inline reference), not 1 (no multi-level nesting).

2 / 3

Total

9

/

12

Passed

Description

85%Weight 40%Scale 1-3

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, third-person description that covers what and when with concrete domain-specific actions. Its main weakness is trigger-term coverage, which leans on technical labels and omits the most common colloquial entry point ('ClinVar').

Suggestions

Add the colloquial term 'ClinVar' and common phrasings like 'variant pathogenicity' or 'look up a variant' to broaden natural trigger coverage.

Consider explicitly contrasting with adjacent databases (e.g., 'use ClinVar, not gnomAD, for clinical significance') to sharpen distinctiveness in the description itself.

DimensionReasoningScore

Specificity

The description names a concrete domain and multiple specific actions: 'clinical significance', 'pathogenicity classifications (e.g., Pathogenic, Benign, VUS)', 'clinical evidence rationales', and 'finding "hard positive" benchmark controls for human genomic variants' — matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It explicitly answers both 'what' (clinical significance / pathogenicity classifications / evidence rationales / benchmark controls) and 'when' via an explicit 'Use when needing ...' clause, matching the 'clearly answers both what AND when with explicit triggers' anchor.

3 / 3

Trigger Term Quality

It includes relevant natural terms like 'Pathogenic, Benign, VUS', 'clinical significance', and 'human genomic variants', but omits common variations a user would actually say such as 'ClinVar', 'variant lookup', or 'pathogenicity' alone. This matches 'some relevant keywords but missing common variations', not 3 (incomplete coverage) and not 1 (terms are natural, not jargon).

2 / 3

Distinctiveness Conflict Risk

The ClinVar clinical-classification niche is clearly distinct from adjacent skills (gnomAD, OMIM, AlphaGenome, PDB) called out later in the body, and its triggers (pathogenicity labels, VUS, clinical evidence rationales) are unlikely to fire for the wrong skill. Matches the 'clear niche with distinct triggers' anchor.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
google-deepmind/science-skills
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.