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.

63

1.06x
Quality

47%

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 precisely when to select this skill over others. Adding trigger guidance would elevate this from a good to an excellent description.

Suggestions

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

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 documentation standards (CARE, SOAP, ICH-E3). Very unlikely to conflict with non-medical skills.

3 / 3

Total

11

/

12

Passed

Implementation

12%

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

This skill is an encyclopedic reference document on clinical report writing rather than an actionable skill for Claude. At over 1000 lines, it exhaustively describes report structures and medical documentation standards that Claude already understands, while failing to provide concrete, executable guidance or working examples. The extensive references to nonexistent bundle files undermine both progressive disclosure and actionability.

Suggestions

Reduce content by 70-80%: Remove definitional content Claude already knows (what HIPAA identifiers are, what SOAP stands for, basic report structures) and focus only on specific formatting rules, constraints, and decision points that are non-obvious.

Add concrete, actionable examples: Include 2-3 complete mini-examples of generated reports (e.g., a short SOAP note, a case report abstract) showing exact expected output format rather than just listing section headers.

Either provide the referenced bundle files (templates, scripts, references) or remove the references and inline only the essential content. Currently all 28 referenced files are missing.

Replace the generic 'Visual Enhancement with Scientific Schematics' section with a brief note or remove it entirely - mandating AI-generated figures for every clinical report is inappropriate and the referenced tool doesn't exist in the bundle.

DimensionReasoningScore

Conciseness

Extremely verbose at ~1000+ lines. Extensively explains concepts Claude already knows (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 instruction. Massive amounts of definitional content that adds no actionable value for Claude.

1 / 3

Actionability

Despite its length, the skill is almost entirely descriptive rather than instructive. It lists what sections a report should contain but provides no executable code, no concrete generation prompts, and no copy-paste-ready templates inline. The one code snippet (`python scripts/generate_schematic.py`) references a script that doesn't exist in the bundle. The content describes report structures rather than giving Claude specific instructions on how to produce them.

1 / 3

Workflow Clarity

Workflows are present (Case Report Workflow with phases, Diagnostic Report Workflow, Clinical Trial Report Workflow) and include some sequencing with timelines. However, there are no validation checkpoints or feedback loops within the writing process itself. The final checklist is useful but is a static list rather than an integrated validation step. The 'validate' scripts are referenced but don't exist in the bundle.

2 / 3

Progressive Disclosure

The skill references numerous external files (8 reference files, 12 template assets, 8 scripts) but none are provided in the bundle. This means all the references are broken - the skill is a monolithic wall of text that tries to be comprehensive inline while also pointing to nonexistent files. The content that should be in those reference files is partially duplicated in the main body, creating the worst of both worlds: verbose inline content AND broken references.

1 / 3

Total

5

/

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.