CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

radiology-image-quiz

Use when creating radiology educational quizzes, preparing board exam questions, or studying medical imaging cases. Generates interactive quizzes with X-ray, CT, MRI, and ultrasound images for medical education.

Quality

66%

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 ./scientific-skills/Academic Writing/radiology-image-quiz/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

35%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 padded with repeated description text and generic boilerplate, and — most damaging — its code examples document an API and CLI (scripts/radiology_quiz.py, quiz.generate/create_case/set_difficulty) that do not match the actual scripts/main.py (generate_quiz(cases), --demo/--cases), making the main executable guidance misleading. The one genuinely useful part is the real, linked reference file and the compile/help verification commands.

Suggestions

Delete the verbatim description repeats in 'When to Use' and 'Key Features' and the generic boilerplate sections (Implementation Details, Output Requirements, Response Template, Error Handling, Input Validation), keeping only radiology-quiz-specific guidance in the body.

Replace the fabricated API examples with the real interface from scripts/main.py: RadiologyQuiz.generate_quiz(cases) and the CLI flags --demo/--cases — remove references to scripts/radiology_quiz.py, quiz.generate(modality=...), create_case, and set_difficulty.

Document the actual input contract — the cases JSON schema (history, findings, options, answer, explanation per case) with a working example — and lay out the real workflow: author cases, run 'python scripts/main.py --cases cases.json', review the printed quiz.

DimensionReasoningScore

Conciseness

The frontmatter description is pasted verbatim three times (When to Use, Key Features, and a malformed 'Use this skill when the task needs Use when creating...'), the py_compile command appears three times, and sections like Implementation Details, Output Requirements, Error Handling, and Response Template are generic process boilerplate Claude already knows. This is noticeably padded, though not to the point of explaining basic concepts, so it sits at 2 rather than 1 or 3.

2 / 5

Actionability

The only verified-executable guidance is 'python -m py_compile scripts/main.py' and 'python scripts/main.py --help'; the Quick Start and Core Capabilities code documents an API that does not exist in scripts/main.py (no generate(modality=...), create, create_case, or set_difficulty methods), and CLI Usage invokes 'scripts/radiology_quiz.py --modality ct' — a file that is not in the bundle, while the real flags (--demo/--cases) are never documented. Concrete detail is present but largely points to fabricated surfaces rather than missing steps entirely, placing it at 2.

2 / 5

Workflow Clarity

A five-step sequenced Workflow with an explicit fallback path exists, but it is generic process boilerplate (confirm objective, validate scope, run, return structure, fallback) rather than a domain workflow — the actual sequence for authoring cases JSON and running main.py with --cases is never laid out, and validation is limited to py_compile. Steps are listed but checkpoints for the real quiz-generation task are missing or implicit, matching anchor 3; it is above 2 because a coherent, non-destructive sequence with an error-recovery branch is present.

3 / 5

Progressive Disclosure

The bundle structure is real and one level deep — scripts/main.py and references/audit-reference.md both exist and audit-reference.md is clearly linked in a References section — but the SKILL.md body inlines large generic boilerplate sections and full API-style examples that belong in references or should be removed, burying the useful content. Some structure with misplaced inline content fits anchor 3 better than 4, whose 'most content appropriately placed' standard is not met.

3 / 5

Total

10

/

20

Passed

Description

83%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 description: concrete, third-person, with an explicit 'Use when' clause covering three realistic scenarios and named imaging modalities. Keyword coverage and distinctiveness are good with only minor gaps.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'creating radiology educational quizzes', 'preparing board exam questions', 'Generates interactive quizzes with X-ray, CT, MRI, and ultrasound images' — but quiz generation is stated twice and no output or question-format detail is given, so coverage has minor gaps. Not 5 because the actions overlap rather than forming a comprehensive set of distinct capabilities; not 3 because more than 1-2 concrete actions are named with specific modalities.

4 / 5

Completeness

Explicitly answers both: 'Generates interactive quizzes with X-ray, CT, MRI, and ultrasound images for medical education' (what, in third person) and 'Use when creating radiology educational quizzes, preparing board exam questions, or studying medical imaging cases' (when, with three concrete trigger scenarios). Matches the anchor for a fully explicit what-plus-when description.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'radiology educational quizzes', 'board exam questions', 'medical imaging cases', 'X-ray, CT, MRI, and ultrasound' — phrases a user would plausibly say. A few natural terms are missing (e.g., 'exam prep', 'teaching cases', 'diagnostic imaging'), so it falls short of the comprehensive-with-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

A clear radiology-quiz niche with modality-specific triggers makes it mostly distinct, but 'board exam questions' and 'medical education' leave minor overlap risk with generic exam-prep or medical-education skills. Not 5 because those broad phrases could trigger a closely related skill; not 3 because the imaging-modality wording firmly anchors the niche.

4 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/radiology-image-quiz/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.