Generate concise (3-4 page), focused medical treatment plans in LaTeX/PDF format for all clinical specialties. Supports general medical treatment, rehabilitation therapy, mental health care, chronic disease management, perioperative care, and pain management. Includes SMART goal frameworks, evidence-based interventions with minimal text citations, regulatory compliance (HIPAA), and professional formatting. Prioritizes brevity and clinical actionability.
68
55%
Does it follow best practices?
Impact
75%
1.44xAverage score across 6 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/treatment-plans/SKILL.mdQuality
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, detailed description that clearly communicates specific capabilities across multiple clinical domains with concrete deliverables (LaTeX/PDF treatment plans). Its main weakness is the absence of an explicit 'Use when...' clause, which would help Claude know exactly when to select this skill. The description is well-written in third person and avoids vague language.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user requests a medical treatment plan, clinical care plan, therapy plan, or asks for formatted clinical documentation in PDF/LaTeX format.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and domains: generating treatment plans in LaTeX/PDF, supporting rehabilitation therapy, mental health care, chronic disease management, perioperative care, pain management, SMART goal frameworks, evidence-based interventions, HIPAA compliance, and professional formatting. | 3 / 3 |
Completeness | Clearly answers 'what does this do' with detailed capabilities, but lacks an explicit 'Use when...' clause or equivalent trigger guidance. The when is only implied through the description of capabilities, which per the rubric caps completeness at 2. | 2 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'treatment plan', 'medical', 'rehabilitation therapy', 'mental health', 'chronic disease', 'pain management', 'perioperative', 'LaTeX', 'PDF', 'HIPAA', 'SMART goals'. These cover a wide range of clinical terminology users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche combining medical treatment plans with LaTeX/PDF output, specific clinical specialties, and regulatory compliance (HIPAA). Unlikely to conflict with other skills due to the very specific domain of clinical treatment plan generation. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill suffers from extreme verbosity, containing extensive descriptions of clinical concepts, LaTeX styling details, and medical knowledge that Claude already possesses, directly contradicting its own stated principle of brevity. While it provides some useful structure (template selection guidance, validation workflow, concrete LaTeX snippets), the signal is buried in noise. The massive inline content should be split across referenced files, and the skill should be reduced to a concise overview with actionable templates and clear workflow steps.
Suggestions
Reduce the main SKILL.md to ~100-150 lines: a quick-start section, template selection table, the validation workflow, and references to separate files for specialty details, LaTeX styling, and examples.
Move the entire 'Professional Document Styling' section (custom boxes, color schemes, troubleshooting, installation) to a separate STYLING.md file and reference it with a one-line link.
Move the detailed specialty components (sections 1-6 under 'Core Capabilities') to separate files (e.g., SPECIALTIES.md or individual files per specialty) since Claude already knows clinical treatment plan components.
Provide at least one complete, executable LaTeX template inline (or in a bundle file) rather than partial snippets, so Claude can immediately generate a working treatment plan without guessing at the full structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This is an extremely verbose document (~1000+ lines) that extensively explains concepts Claude already knows (SMART goals, HIPAA, what rehabilitation is, what mental health treatment plans contain, LaTeX compilation, etc.). The irony is palpable: a skill that repeatedly emphasizes 'brevity and clinical actionability' is itself massively bloated. Exhaustive lists of conditions, detailed explanations of box types, color RGB values, font installation instructions, and lengthy descriptions of standard clinical components all waste tokens on information Claude already possesses. | 1 / 3 |
Actionability | The skill provides some concrete LaTeX code examples, bash commands for compilation and validation scripts, and specific template names. However, much of the content is descriptive rather than instructive (e.g., listing what components a rehabilitation plan should have rather than showing a concrete template). The LaTeX examples are partial snippets rather than complete executable templates, and key scripts referenced (check_completeness.py, validate_treatment_plan.py, generate_schematic.py) are not provided in any bundle. | 2 / 3 |
Workflow Clarity | The validation workflow section (near the end) provides a clear 7-step sequence including validation checkpoints (check completeness, validate quality, review checklist). However, the overall document structure makes it hard to find this workflow amidst hundreds of lines of descriptive content. The workflow lacks explicit error-handling feedback loops (e.g., what to do if validation fails) and the referenced scripts don't exist in the bundle. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no bundle files provided to support the numerous references (quality_checklist.md, templates, scripts, assets/medical_treatment_plan.sty). The entire content—from clinical specialty details to LaTeX styling to troubleshooting to ethical considerations—is inlined in a single massive file. Content that should clearly be in separate files (e.g., the entire 'Professional Document Styling' section, the detailed specialty components, the LaTeX style package documentation) bloats the main skill file enormously. | 1 / 3 |
Total | 6 / 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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (1581 lines); consider splitting into references/ and linking | Warning |
metadata_version | 'metadata.version' is missing | Warning |
Total | 9 / 11 Passed | |
cbcae7b
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.