CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gnomad-graphql-skill

Submit compact gnomAD GraphQL requests for frequency, gene constraint, and variant context queries. Use when a user wants concise gnomAD summaries

72

Quality

91%

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.

The body is an exemplary compact skill: lean operational guidance, a runnable example with realistic input, fully specified success/error output contracts, and an appropriately minimal file structure whose single script reference is real and matches the documented behavior. Nothing is padded, and every section is directly actionable.

DimensionReasoningScore

Conciseness

The body is ~33 lines of purely operational content — rules, I/O contracts, one runnable command, and two compact query patterns — with no explanation of GraphQL or gnomAD concepts Claude already knows. Every token earns its place (the Execution block's reuse of the Input example query is a trivial, harmless duplication), matching the 'lean and efficient; assumes Claude's competence' anchor rather than 4's 'minor instances that could be trimmed'.

5 / 5

Actionability

The Execution section gives a copy-paste-ready command (`echo '{"query":...}' | python scripts/gnomad_graphql.py`), and Input provides a complete real-world example with an actual variant ID, dataset, and max_items value. Output and error contracts are fully enumerated, covering the common cases — the 'fully executable; copy-paste ready; covers common cases' anchor, not 4 which allows 'minor gaps'.

5 / 5

Workflow Clarity

This is a simple single-task skill whose one action is unambiguous: pipe one JSON object into the script and interpret the documented response. The enumerated error codes (invalid_json, network_error, graphql_error, etc.) supply failure feedback, and the operation is a read-only query — not destructive or batch — so the validation cap does not apply; the simple-skill exception for an unambiguous single action is met, placing it above 4.

5 / 5

Progressive Disclosure

At 33 lines with well-organized sections (rules, behavior, Input, Output, Execution, References), the single referenced file `scripts/gnomad_graphql.py` exists in the bundle, and the References section explicitly and correctly states no further runtime references are needed. Per the rubric's simple-skill guidance (under 50 lines, no need for external references), well-organized sections alone warrant the top anchor.

5 / 5

Total

20

/

20

Passed

Description

78%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 concise, specific description in third person that explicitly covers both what the skill does and when to use it, with a clear niche that avoids conflicts with other skills. Its only weakness is modest trigger coverage — a single 'Use when' phrase without the synonyms and concrete triggers (population/allele frequency, gnomAD v4, variant IDs) that would make invocation more reliable.

Suggestions

Expand the trigger clause with concrete invocation phrases, e.g. 'Use when the user mentions gnomAD, population or allele frequency (AF), gene constraint scores, or wants a concise summary for a variant ID or gene.'

Add common synonyms such as 'population frequency', 'AF', and 'gnomAD v4' to the description so users' natural phrasings match without exact terminology.

DimensionReasoningScore

Specificity

The description names the domain and three concrete capabilities ("frequency, gene constraint, and variant context queries") with a specific verb ("Submit compact gnomAD GraphQL requests"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because it lists query domains rather than a comprehensive set of distinct actions, and is well above 3's '1-2 concrete actions'.

4 / 5

Completeness

Both what ("Submit compact gnomAD GraphQL requests for frequency, gene constraint, and variant context queries") and when ("Use when a user wants concise gnomAD summaries") are explicitly stated in third person. It is below 5 because the when clause offers only one trigger phrase rather than concrete, varied trigger situations (e.g., 'when the user mentions variant IDs, constraint scores, or population frequency').

4 / 5

Trigger Term Quality

Natural keywords like "gnomAD", "GraphQL", "frequency", "gene constraint", and "variant" are present and would be said by users needing this skill, but common variations are missing ("population frequency", "allele frequency"/"AF", "gnomAD v4", "variant ID"). This matches 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

"gnomAD GraphQL" carves out a clear niche with distinct triggers (gnomAD, gene constraint, variant frequency) that no generic skill would claim, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor. It is not a 4 because it does not overlap with closely related skills — the scope is tightly and uniquely scoped.

5 / 5

Total

17

/

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

openai/plugins

Path

plugins/life-science-research/skills/gnomad-graphql-skill/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.