CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clinical-reports

Creates safety-bounded draft structures and runs local deterministic checks for clinical case, diagnostic, trial, safety, and aggregate research reports. Use only with synthetic, de-identified, or aggregate inputs and verified source-fact manifests; every output requires qualified review.

65

Quality

82%

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

78%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.

An unusually well-engineered safety-critical skill body: fully executable commands with verified flags, a gated five-step workflow with per-artifact validation, and clean one-level-deep progressive disclosure across 11 references, 15 assets, and 9 scripts. The one real weakness is conciseness — dated standards facts inline (duplicating the references) and repeated boundary statements could be consolidated.

Suggestions

Move the inline version/adoption facts (CONSORT/SPIRIT item counts, ICH E6(R3) and E2D(R1) adoption dates) into references/clinical_trial_reporting.md and sources.md, keeping only the routing pointer and a single 'see sources.md for current versions' note in SKILL.md.

Consolidate the repeated never-sign/never-submit boundary statements (Non-Negotiable Boundary, workflow step 5, and Final Handoff) into one canonical section referenced from the other two locations.

Trim the route table's 'Important boundary' column into references/report_type_routing.md, since the body already directs the reader there before choosing a route.

DimensionReasoningScore

Conciseness

The body is dense and free of tutorial padding — nearly every line is skill-specific instruction Claude would not know otherwise. However, substantial time-sensitive information sits inline ("CONSORT 2025 has 30 minimum items", "SPIRIT 2025 has 34", "ICH E6(R3) ... adopted on 16 June 2026", "E2D(R1), adopted 15 September 2025", "ACR 2025", "checked 2026-09-30") rather than being confined to a versions/deprecated section, much of it duplicating references/clinical_trial_reporting.md, and the never-sign/never-submit boundary is restated in three places. That fits anchor 3 ('mostly efficient but could be tightened') — not 4, because the dated-fact and repetition volume is noticeable, and not 2, because there is no padding and every sentence carries instruction.

3 / 5

Actionability

Nine fully executable, copy-paste-ready bash commands cover every artifact type; flags were verified against the scripts' argparse (--list, --type, --output, --metadata all exist and `generate_report_template.py --list` runs successfully). Field-level population rules are concrete ("Replace `null` only when a verified fact ID supports the field", "Keep `draft_status` unchanged") and every asset/reference path cited resolves to a real bundle file. This matches anchor 5.

5 / 5

Workflow Clarity

The Safe Drafting Workflow is a clearly sequenced 5-step process (manifest → generate template → populate verified fields only → run deterministic checks → apply the right review) with a dedicated validation step per artifact type and honest scope caveats (checks validate fact-ID shape, provenance must be run separately, "A successful result still says review is required"). It falls short of anchor 5 because there is no explicit error-recovery feedback loop (no 'if a check fails, fix and re-run'); it is above anchor 3 because validation checkpoints are explicit and the fail-closed design is stated.

4 / 5

Progressive Disclosure

The body is a clear overview: each domain section signals its one-level-deep reference by name with purpose, the References section annotates all 11 files, the route table summarizes what references/report_type_routing.md details, and all 26 referenced paths (references, assets, scripts) exist in the bundle. Grep confirms references point only to assets/scripts and never to each other, so there is no reference nesting. This matches anchor 5.

5 / 5

Total

17

/

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 strong, third-person description that clearly states what the skill does, its clinical-reporting niche, and explicit use preconditions. The main gaps are missing natural trigger phrasing and common synonyms/acronyms (CSR, ICSR, manuscript) that would improve invocation matching.

Suggestions

Add a natural trigger clause naming user-side phrasing, e.g., 'Use when asked to draft or structurally check a clinical case report, diagnostic report scaffold, trial results/protocol report, CSR, or aggregate safety table.'

Include common synonyms and acronyms users actually say — 'case report', 'CSR', 'ICSR', 'manuscript draft' — to raise trigger-term coverage to anchor 5.

Mention one or two more concrete capabilities (e.g., provenance manifest creation, report-type routing) to lift specificity from two actions to several.

DimensionReasoningScore

Specificity

The description names two concrete actions — "Creates safety-bounded draft structures and runs local deterministic checks" — across five enumerated report domains ("clinical case, diagnostic, trial, safety, and aggregate research reports"). This exceeds anchor 3 (domain plus 1-2 actions with thin coverage) because the domain enumeration is comprehensive, but falls short of anchor 5, which expects multiple distinct actions; routing, provenance manifests, and template generation are absent.

4 / 5

Completeness

The 'what' is clear (creates draft structures, runs deterministic checks, five report types). The 'when' is present as an explicit use-condition — "Use only with synthetic, de-identified, or aggregate inputs and verified source-fact manifests" — which is equivalent explicit trigger guidance, so the score is not capped at 3. It is not a 5 because the clause states input preconditions rather than natural invocation triggers (e.g., 'Use when asked to draft a case report or trial results manuscript').

4 / 5

Trigger Term Quality

Natural keywords are present and varied: "clinical case", "diagnostic", "trial", "safety", "aggregate research reports", "de-identified". A few natural terms users would actually say are missing — no "case report", "CSR", "ICSR", "manuscript", "CARE"/"CONSORT", or file extensions — so it fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The phrase "clinical case, diagnostic, trial, safety, and aggregate research reports" carves out a clear clinical-reporting niche with distinct triggers and minimal overlap with generic document or data skills, matching anchor 5. Third-person voice ("Creates", "runs") is used throughout, so no voice penalty applies.

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

K-Dense-AI/scientific-agent-skills

Path

skills/clinical-reports/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.