CtrlK
BlogDocsLog inGet started
Tessl Logo

clinicaltrials-database

Query ClinicalTrials.gov via API v2. Search trials by condition, drug, location, status, or phase. Retrieve trial details by NCT ID, export data, for clinical research and patient matching.

60

Quality

72%

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 ./scientific-skills/clinicaltrials-database/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 highly actionable — every capability ships complete, executable code with correct parameter names, valid enums, and response structure navigation, backed by real bundle files. Its weaknesses are verbosity (overview filler, repeated use-case bullets, and an off-topic promotional section) and a body length that would sit better behind the existing one-level-deep references.

Suggestions

Trim the overview paragraph explaining what ClinicalTrials.gov is, drop the per-section 'Common use cases' bullet lists, and remove the K-Dense Web promotional section — none add information Claude lacks.

Consolidate the Quick Start to one approach (the helper script) instead of showing both raw requests and the script for the same query.

Move the bulk of the ten capability code examples into references/api_reference.md, keeping a compact quick start and brief capability summary in SKILL.md.

DimensionReasoningScore

Conciseness

Mostly efficient code examples, but padded with content Claude already knows — the overview paragraph explaining what ClinicalTrials.gov is, repeated 'Common use cases' bullet lists after every section, a duplicate raw-requests example in Quick Start alongside the helper-script version, and a promotional K-Dense Web section unrelated to executing the skill. Not 2 because the bulk is concrete executable guidance; not 4 because several sections could be trimmed without losing information.

3 / 5

Actionability

Every capability is illustrated with copy-paste-ready executable Python, the valid status enum values are enumerated, exact API parameter names and response key paths are given, and the referenced helper script (scripts/query_clinicaltrials.py) exists. Common cases — search, detail retrieval, pagination, CSV export — are all covered with runnable code.

5 / 5

Workflow Clarity

Capabilities are clearly sequenced (quick start → search patterns → details → pagination → export) with error-handling and rate-limit retry/backoff shown for batch retrieval, and pagination includes a max_pages guard. Not 5 because validation checkpoints are implicit rather than explicit (e.g. no verify step after CSV export or bulk retrieval); not 3 because error handling and rate-limit feedback loops are present.

4 / 5

Progressive Disclosure

Good structure with a Resources section clearly describing both bundle files; scripts/query_clinicaltrials.py and references/api_reference.md exist and references are one level deep (no nested references found). Not 5 because the body itself is ~500 lines with ten full inline capability sections whose code could largely live in the reference; not 3 because navigation is clear and the split is mostly appropriate.

4 / 5

Total

16

/

20

Passed

Description

70%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 is specific and clearly distinct, naming the source (ClinicalTrials.gov API v2) and concrete actions with useful trigger terms like NCT ID and patient matching. Its main weakness is the absence of an explicit 'Use when...' clause — the 'for clinical research and patient matching' purpose clause only weakly implies when to invoke it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions clinical trials, ClinicalTrials.gov, NCT IDs, or patient/trial matching.'

Make 'export data' concrete by naming what is exported and to what format (e.g. 'export trial data to CSV').

Include common synonyms such as 'clinical study' or 'medical trial' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Search trials by condition, drug, location, status, or phase' and 'Retrieve trial details by NCT ID' — but 'export data' is generic, leaving minor gaps in coverage. Not 5 because export format and what is exported are unspecified; not 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

The 'what' is clear (search, retrieve, export), but 'when' is only weakly implied by the purpose clause 'for clinical research and patient matching' — there is no explicit 'Use when...' trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the trigger scenarios are not explicit; not 2 because both a clear what and an implied purpose are present.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('clinical research', 'patient matching', 'NCT ID', condition/drug/status/phase), but common synonyms like 'study', 'medical trial', or 'clinical study' are missing. Not 5 because coverage lacks natural variations; not 3 because most relevant terms users would say are present.

4 / 5

Distinctiveness Conflict Risk

Highly distinct niche: 'ClinicalTrials.gov via API v2', 'trial details by NCT ID', 'patient matching' — no other common skill would trigger for these phrases. Minimal conflict risk.

5 / 5

Total

16

/

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

skill_md_line_count

SKILL.md is long (507 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

14

/

16

Passed

Repository
googolme/run0204
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.