Generate hospital discharge summaries from admission data, hospital course.
49
37%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/discharge-summary-writer/SKILL.mdQuality
Discovery
40%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 identifies a clear and specific clinical niche (hospital discharge summaries), which gives it good distinctiveness. However, it lacks an explicit 'Use when...' clause, limiting its completeness, and could benefit from more concrete actions and natural trigger terms that users in clinical settings would use.
Suggestions
Add a 'Use when...' clause with trigger terms like 'discharge summary', 'discharge note', 'DC summary', 'patient discharge', or 'clinical summary'.
List more specific actions such as 'compiles diagnosis lists, medication reconciliation, follow-up instructions, and patient education from admission data and hospital course notes'.
Include common synonyms and abbreviations clinicians use, such as 'DC summary', 'discharge note', 'patient summary', 'clinical documentation'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (hospital discharge summaries) and a couple of inputs (admission data, hospital course), but doesn't list multiple concrete actions beyond 'generate'. It could mention specific sections like medication reconciliation, follow-up instructions, diagnosis coding, etc. | 2 / 3 |
Completeness | Describes what the skill does (generate discharge summaries) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and since the 'when' is entirely missing, this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like 'hospital discharge summaries', 'admission data', and 'hospital course', but misses common variations users might say such as 'discharge note', 'patient summary', 'discharge instructions', 'DC summary', or 'clinical summary'. | 2 / 3 |
Distinctiveness Conflict Risk | The description targets a very specific clinical documentation niche—hospital discharge summaries—which is unlikely to conflict with other skills. The medical domain specificity makes it clearly distinguishable. | 3 / 3 |
Total | 8 / 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 is excessively verbose with significant boilerplate content that doesn't serve the specific task of generating discharge summaries. While the input JSON schema and parameter table provide concrete guidance, the workflow steps are generic rather than domain-specific, and the document is padded with sections like Risk Assessment, Security Checklist, and Lifecycle Status that add little actionable value. The skill would benefit greatly from cutting 60%+ of the content and focusing on the actual clinical document generation process.
Suggestions
Remove generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't provide discharge-summary-specific guidance—these waste tokens on content Claude already knows.
Replace the abstract workflow steps with concrete, domain-specific steps for discharge summary generation (e.g., 'Verify all discharge diagnoses are present', 'Cross-check medication list against hospital course', 'Validate follow-up instructions match discharge condition').
Add a concrete example showing sample input data and the expected discharge summary output, so Claude can see the exact format and clinical tone expected.
Fix broken cross-references ('See ## Prerequisites above' appears before Prerequisites) and consolidate duplicate content (--help listed 3 times in Audit-Ready Commands).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. Contains numerous sections that add no value (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria with generic test cases). Multiple cross-references to sections that don't exist ('See ## Prerequisites above'). The Audit-Ready Commands section lists `--help` three times. Much of the content is boilerplate that Claude already knows (error handling principles, input validation concepts, response templates). | 1 / 3 |
Actionability | The input JSON schema is concrete and well-defined, and the CLI parameters table is useful. However, the actual script is never shown—we only see how to invoke it. The workflow steps are generic ('Confirm the user objective') rather than specific to discharge summary generation. No example of actual output is provided, and the 'Example run plan' is vague. | 2 / 3 |
Workflow Clarity | There is a numbered workflow, but it is generic and not specific to discharge summary generation. Steps like 'Validate that the request matches the documented scope' are abstract. The safety considerations mention physician review, but there's no explicit validation checkpoint integrated into the workflow itself (e.g., validate medication dosages before finalizing). The error handling section provides some fallback guidance but is disconnected from the main workflow. | 2 / 3 |
Progressive Disclosure | References to external files (references/discharge_template.md, references/medical_terms.json, references/section_guidelines.md) are mentioned, which is good. However, the SKILL.md itself is a monolithic wall of text with many sections that could be externalized (Risk Assessment, Security Checklist, Evaluation Criteria). The cross-references ('See ## Prerequisites above') point to sections that appear later in the document, creating confusion. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8277276
Table of Contents
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.