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

88%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

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

The content is highly actionable with executable code and CLI usage plus a strong QA/checklist workflow, but is weighed down by templated boilerplate and inlines capability detail that would be better split into the existing references/ and scripts/ bundles. Weakest on conciseness and progressive disclosure.

Suggestions

Remove the templated echo of the description in 'When to Use'/'Key Features' and the generic 'Implementation Details' and 'Workflow' boilerplate to tighten token efficiency.

Move the five 'Core Capabilities' code/API sections into a dedicated reference file (e.g. references/capabilities.md) and point to it from a concise overview, deepening use of the existing references/ bundle.

Resolve the Quick Start's `from scripts.discharge_drafter import DischargeDrafter` against the actual entry point (scripts/main.py defines DischargeDrafter) so the copy-paste example is directly executable.

Dimension	Reasoning	Score
Conciseness	The body carries substantial templated boilerplate (repeated 'When to Use' verbatim description echo, 'Key Features', 'Implementation Details', generic 'Workflow', 'Response Template') that pads tokens without adding domain knowledge Claude lacks, keeping it below the lean score-3 anchor.	2 / 3
Actionability	Provides concrete, copy-paste-ready Python examples and CLI commands with real flags and parameters (e.g. `python scripts/discharge_drafter.py --patient PT12345 --digital-twin-model ... --include-predictions`), matching the score-3 anchor for fully executable guidance.	3 / 3
Workflow Clarity	A numbered Workflow with explicit validation/stop-early checkpoints plus a Pre-/Discharge/Post-discharge QA checklist and Error Handling feedback paths match the score-3 anchor of clear sequences with explicit validation steps and checklists.	3 / 3
Progressive Disclosure	The body references `scripts/main.py`, `references/`, and bundles exist (references/discharge_template.md, references/medical_terms.json, scripts/main.py), but the body inlines ~300 lines of capability/API detail that could live in separate reference files and references are not clearly signaled as navigation hubs, matching the score-2 anchor of structure present but content that should be separate is inline.	2 / 3
	Total	10 / 12 Passed

Description

100%

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

The description is specific, trigger-rich, and complete, cleanly answering both what the skill does and when to invoke it within a distinct clinical niche. No vague fluff or first/second person voice is present.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('drafting patient discharge summaries, creating personalized discharge instructions, simulating post-discharge outcomes, reducing hospital readmissions, optimizing care transitions') matching the score-3 anchor of multiple specific concrete actions.	3 / 3
Completeness	Explicitly answers 'what' ('Generates AI-enhanced discharge documentation with digital twin predictions') and 'when' ('Use when drafting...') with an explicit trigger clause, matching the score-3 anchor for both.	3 / 3
Trigger Term Quality	Covers natural terms a user would say ('discharge summaries', 'discharge instructions', 'post-discharge outcomes', 'readmissions', 'care transitions') with good breadth, matching the score-3 anchor.	3 / 3
Distinctiveness Conflict Risk	Occupies a clear, narrow niche (digital-twin-driven discharge drafting) with distinct triggers unlikely to collide with other skills, matching the score-3 anchor for a clear niche.	3 / 3
	Total	12 / 12 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 7cc5680

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.