CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

digital-twin-discharge-drafter

Use when drafting patient discharge summaries, creating personalized discharge instructions, simulating post-discharge outcomes, reducing hospital readmissions, or optimizing care transitions. Generates AI-enhanced discharge documentation with digital twin predictions for improved patient safety.

Quality

69%

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/digital-twin-discharge-drafter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 reads like template-generated boilerplate stitched around a real domain core: the description is duplicated twice, generic governance sections pad the token budget, and one bullet is leftover from an academic-writing template. Most critically, the showcase CLI and API examples reference a non-existent script path, non-existent CLI flags, and a non-existent create_summary() method, so a user following them verbatim would immediately fail.

Suggestions

Fix the executable examples to match the actual bundle: replace 'scripts/discharge_drafter.py' with 'scripts/main.py', correct the import to 'from scripts.main import DischargeDrafter', remove the undocumented CLI flags (--batch, --priority, --auto-escalate-risk, --mode, --reading-level, --language, --output), and remove or implement the non-existent drafter.create_summary() call.

Cut the padded boilerplate: delete the two verbatim re-pastes of the frontmatter description ('When to Use', 'Key Features') and the generic 'Implementation Details'/'Output Requirements'/'Response Template'/'Input Validation' sections, and drop the mismatched 'academic writing tasks' bullet.

Move the bulk API reference ('Core Capabilities', 'Common Patterns', quality checklists) into references/ files and link them by name (e.g., discharge_template.md) so SKILL.md stays a lean overview with clearly signaled one-level-deep references.

DimensionReasoningScore

Conciseness

Noticeably verbose with several padded sections: the frontmatter description is pasted verbatim twice in the body ('When to Use' line and 'Key Features' line), and generic governance boilerplate ('Implementation Details', 'Output Requirements', 'Response Template', 'Input Validation') adds little skill-specific value. Line 16 even instructs 'Use this skill for academic writing tasks' — mismatched template residue from a different skill. Not 1 because the body does not explain basic concepts Claude already knows and contains real domain content (risk stratification tables, QA checks); not 3 because duplicated description text, four boilerplate sections, and a mismatched bullet go beyond isolated tightening.

2 / 5

Actionability

Concrete code and commands exist, but a significant fraction will not execute against the actual bundle: the CLI section targets 'scripts/discharge_drafter.py' which does not exist (only scripts/main.py), and shows flags (--batch, --priority, --auto-escalate-risk, --mode, --reading-level, --language, --output) that main.py does not define (it accepts only --patient, --digital-twin-model, --include-predictions, --output-format, --output-dir). The Quick Start imports 'from scripts.discharge_drafter import DischargeDrafter' (wrong module) and Core Capability 1 calls 'drafter.create_summary()', which does not exist in main.py. Not 4 because these gaps are not minor — the primary CLI and API examples fail as written; not 2 because some examples are genuinely correct (generate(), simulate_outcomes() signatures match, and the py_compile/--help commands target the real script).

3 / 5

Workflow Clarity

The 'Workflow' section lists a coherent 5-step sequence (confirm -> validate scope -> execute -> structured result -> fallback) plus a 'Quick Check' py_compile validation, but the steps are generic template prose not tied to concrete commands or checkpoints per step. The batch CLI example ('--batch high_risk_patients.csv') involves batch operations with no validation step, which per the rubric caps this dimension at 3. Not 2 because a real sequence with error-handling and fallback guidance is present; not 4 because checkpoints are implicit and the batch path lacks any verification step.

3 / 5

Progressive Disclosure

The bundle provides references/discharge_template.md and references/medical_terms.json, but the body only gestures at 'Reference material available in `references/`' without naming or linking either file. Meanwhile ~100 lines of API reference ('Core Capabilities', 'Common Patterns', checklists) that belong in reference files are inlined in SKILL.md. Not 2 because the document is well-sectioned with headers and references do exist; not 4 because references are not clearly signaled by name and bulk API content is inline rather than split out.

3 / 5

Total

11

/

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 in the exact two-part pattern the rubric rewards: a concrete 'what' plus an explicit 'Use when' clause with multiple natural trigger phrases in third-person voice. Minor deductions for outcome-claims presented as actions ('reducing hospital readmissions') and slightly buzzwordy framing ('AI-enhanced').

DimensionReasoningScore

Specificity

Lists several concrete actions — 'drafting patient discharge summaries', 'creating personalized discharge instructions', 'simulating post-discharge outcomes', 'optimizing care transitions', 'Generates AI-enhanced discharge documentation' — with minor gaps: 'reducing hospital readmissions' is an outcome/goal rather than an action the skill performs, and 'AI-enhanced... digital twin predictions' leans slightly on buzzword framing. Not 5 because a couple of the listed verbs are aspirational outcomes rather than executable capabilities; not 3 because well more than 1-2 concrete actions are explicitly named.

4 / 5

Completeness

Explicitly answers both: 'Generates AI-enhanced discharge documentation with digital twin predictions' (what) and 'Use when drafting patient discharge summaries, creating personalized discharge instructions, simulating post-discharge outcomes...' (when, with multiple concrete trigger phrases). Structure mirrors the score-5 anchor example. Both clauses are present, explicit, and use third-person voice.

5 / 5

Trigger Term Quality

Good coverage of natural phrases a clinical user would say: 'patient discharge summaries', 'discharge instructions', 'post-discharge outcomes', 'hospital readmissions', 'care transitions', 'discharge documentation'. Not 5 because common variations are missing (e.g., 'discharge paperwork', 'discharge plan', 'readmission risk', 'patient handout'); not 3 because coverage goes well beyond a couple of relevant keywords.

4 / 5

Distinctiveness Conflict Risk

The digital-twin/discharge niche is fairly distinct — 'digital twin predictions', 'simulating post-discharge outcomes', 'reducing hospital readmissions' are unlikely to fire for unrelated skills. Not 5 because 'personalized discharge instructions' and 'optimizing care transitions' could overlap with generic patient-education or clinical-documentation skills; not 3 because the core triggers are clearly tied to this specific domain.

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: 3 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/digital-twin-discharge-drafter/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.