CtrlK
BlogDocsLog inGet started
Tessl Logo

clinical-reports

Write comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation (SOAP, H&P, discharge summaries). Full support with templates, regulatory compliance (HIPAA, FDA, ICH-GCP), and validation tools.

70

1.06x
Quality

58%

Does it follow best practices?

Impact

94%

1.06x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/clinical-reports/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description with excellent specificity and domain-specific trigger terms that clearly carve out a clinical report writing niche. The main weakness is the absence of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill over others. Adding trigger guidance would elevate this from good to excellent.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to write, draft, or review clinical reports, medical documentation, case reports, or clinical trial documents.'

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and document types: case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), patient documentation (SOAP, H&P, discharge summaries), plus templates, regulatory compliance, and validation tools.

3 / 3

Completeness

The 'what' is thoroughly covered with specific report types and features, but there is no explicit 'Use when...' clause or equivalent trigger guidance telling Claude when to select this skill. Per rubric guidelines, this caps completeness at 2.

2 / 3

Trigger Term Quality

Excellent coverage of natural terms a user would say: 'clinical reports', 'case reports', 'SOAP', 'discharge summaries', 'radiology', 'pathology', 'clinical trial', 'HIPAA', 'FDA', 'H&P', 'CSR', 'SAE'. These are terms clinicians and researchers would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused on clinical and medical report writing with specific regulatory frameworks (HIPAA, FDA, ICH-GCP) and clinical document types (SOAP, H&P). Very unlikely to conflict with non-medical skills.

3 / 3

Total

11

/

12

Passed

Implementation

35%

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

This skill file is essentially a comprehensive medical documentation textbook crammed into a single SKILL.md. While it demonstrates thorough domain knowledge and provides useful structural templates and examples, it massively violates conciseness by including detailed content that should reside in the referenced files. The skill would be far more effective as a concise overview (~100-150 lines) pointing to the well-organized reference and template files it already lists.

Suggestions

Reduce SKILL.md to a concise overview (100-150 lines) with brief descriptions of each report type and clear pointers to the reference files and templates that already exist in the references/ and assets/ directories.

Move detailed structural templates (radiology report structure, pathology report structure, SOAP note components, H&P components, etc.) into their respective assets/ template files rather than duplicating them inline.

Add explicit validation checkpoints to workflows, e.g., 'Run scripts/check_deidentification.py before proceeding to submission' with actual executable code examples for the validation scripts.

Remove the mandatory scientific-schematics integration section or reduce it to 1-2 lines — it's tangential to clinical report writing and adds significant bloat with questionable relevance.

DimensionReasoningScore

Conciseness

Extremely verbose at ~800+ lines. Explains concepts Claude already knows extensively (what HIPAA is, what SOAP notes are, what radiology reports contain, basic medical terminology standards). The content reads like a medical documentation textbook rather than a concise skill file. Massive amounts of information that could be in referenced files is inline.

1 / 3

Actionability

Provides detailed structural templates and examples (e.g., SOAP note examples, radiology report examples, SAE components), which are somewhat actionable. However, the referenced scripts (validate_case_report.py, check_deidentification.py) are listed but no executable code is provided. The 'generate_schematic.py' command is given but likely doesn't exist. Most guidance is descriptive rather than executable.

2 / 3

Workflow Clarity

Workflows are listed for case reports, diagnostic reports, and clinical trial reports with phases and timelines, but they lack explicit validation checkpoints and feedback loops. The final checklist is helpful but is a static list rather than an integrated validation step. No 'validate then proceed' pattern for destructive or compliance-critical operations like de-identification verification.

2 / 3

Progressive Disclosure

References to external files are well-organized (references/ and assets/ directories clearly listed), but the SKILL.md itself is a monolithic wall of text containing hundreds of lines of detail that should be in those referenced files. The radiology report structure, pathology report structure, lab report structure, H&P components, etc. should all be in their respective template/reference files rather than inline.

2 / 3

Total

7

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

metadata_version

'metadata.version' is missing

Warning

Total

9

/

11

Passed

Repository
K-Dense-AI/claude-scientific-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.