Alterlab treatment plans
Skill AlterLab-IEU/AlterLab-Academic-Skills/skills/clinical-research/alterlab-treatment-plans
Generates concise (3-4 page), focused medical treatment plans in LaTeX/PDF format across all clinical specialties — general medical treatment, rehabilitation therapy, mental health care, chronic disease management, perioperative care, and pain management — using SMART goal frameworks, evidence-based interventions with minimal citations, HIPAA compliance, and professional formatting. Use when drafting a brief, actionable patient treatment or care plan with measurable SMART goals and structured follow-up for any specialty. Part of the AlterLab Academic Skills suite.From its SKILL.md
npx -y skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-treatment-plansAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
8.4 KB, ~1.6k tokens by cl100k_base, as published. Nobody here has run it
Treatment Plan Writing
Overview
Treatment plan writing is the systematic documentation of clinical care strategies designed to address patient health conditions through evidence-based interventions, measurable goals, and structured follow-up. This skill provides LaTeX templates and validation tools for creating concise, focused treatment plans (3-4 pages standard) across all medical specialties with full regulatory compliance.
Critical Principles:
- CONCISE & ACTIONABLE: Treatment plans default to 3-4 pages maximum (1 page preferred for standard cases), focusing only on clinically essential information that impacts care decisions
- Patient-Centered: Plans must be evidence-based, measurable, and compliant with healthcare regulations (HIPAA, documentation standards)
- Minimal Citations: Use brief in-text citations only when needed; avoid extensive bibliographies (0-3 citations max in a 3-4 page plan)
Every treatment plan should include clear goals, specific interventions, defined timelines, monitoring parameters, and expected outcomes that align with patient preferences and current clinical guidelines — all presented as efficiently as possible.
When to Use This Skill
Use this skill when:
- Creating individualized treatment plans for patient care
- Documenting therapeutic interventions for chronic disease management
- Developing rehabilitation programs (physical, occupational, cardiac)
- Writing mental health and psychiatric treatment plans
- Planning perioperative and surgical care pathways
- Establishing pain management protocols
- Setting patient-centered goals using SMART criteria
- Coordinating multidisciplinary care across specialties
- Ensuring regulatory compliance in treatment documentation
Core Workflow
- Choose format and length. Default to the 1-page quick-reference card; expand to the 3-4 page standard format (first-page summary + details) only when complexity demands. See
references/document_formats.md. - Build the mandatory first-page executive summary. Title + report info box + 2-4 colored key-findings boxes (goals, interventions, decision points). This page can often stand alone. Full spec and LaTeX skeleton in
references/document_formats.md. - Pick the specialty template from
assets/and fill its component sections. Component checklists per specialty (general medical, rehab, mental health, chronic disease, perioperative, pain) are inreferences/specialty_components.md. - Write SMART goals (Specific, Measurable, Achievable, Relevant, Time-bound) for short- and long-term horizons.
- Apply professional styling with the
medical_treatment_plan.stypackage — seereferences/latex_styling.md. - Validate, then generate PDF. Run completeness and quality checks, compare against the quality checklist, then compile. See
references/templates_and_validation.md.
Six Specialty Plan Types
| # | Type | Template (assets/) | Use for |
|---|---|---|---|
| 1 | General Medical | general_medical_treatment_plan.tex | Chronic disease, acute medical, primary care |
| 2 | Rehabilitation | rehabilitation_treatment_plan.tex | PT/OT/SLP, post-surgery, injury recovery |
| 3 | Mental Health | mental_health_treatment_plan.tex | Psychiatric conditions, behavioral health |
| 4 | Chronic Disease | chronic_disease_management_plan.tex | Complex multi-condition long-term care |
| 5 | Perioperative | perioperative_care_plan.tex | Surgical/procedural pre-, peri-, post-op |
| 6 | Pain Management | pain_management_plan.tex | Acute/chronic pain, opioid-sparing multimodal |
Per-specialty required component breakdowns (assessments, goals, interventions, monitoring, education, risk mitigation) are documented in references/specialty_components.md.
Quick Generation
# Interactive template selection
python scripts/generate_template.py
# Or specify type directly. Default to one_page (the preferred quick-reference
# format) for most cases; pick a specialty template when complexity demands it.
python scripts/generate_template.py --type one_page --output diabetes_plan.tex
python scripts/generate_template.py --type mental_health --output depression_treatment_plan.tex
# Type choices: one_page, general_medical, rehabilitation, mental_health,
# chronic_disease, perioperative, pain_management
# Validate, then compile
python scripts/check_completeness.py plan.tex
python scripts/validate_treatment_plan.py plan.tex
pdflatex plan.tex
Professional Document Styling
Treatment plans can be enhanced with professional medical document styling using the medical_treatment_plan.sty LaTeX package (in assets/), which provides a color-coded clinical look with custom box environments (infobox, warningbox, goalbox, keybox, emergencybox, patientinfo) and styled medical tables.
For the full styling guide — color scheme, every box environment with examples, table formatting, compilation (XeLaTeX/PDFLaTeX), customization, installation, troubleshooting, and a worked styled-document example — see references/latex_styling.md.
Reference Index
| File | Contents |
|---|---|
references/document_formats.md | Length options (1-page / 3-4 / 5-6), Foundation-Medicine first-page summary model with LaTeX skeleton, concise-documentation rules, citation guidance, full best-practices (brevity, SMART, patient-centered, compliance, coordination) |
references/specialty_components.md | Full required-component checklists for all six specialty plan types |
references/worked_examples.md | Five end-to-end scenarios (diabetes, post-stroke rehab, MDD, TKA, chronic low back pain) with template, goals, interventions |
references/templates_and_validation.md | Template selection/structure, PDF generation, completeness & quality validation scripts, quality checklist, timeline generation, professional standards, cross-skill integration |
references/latex_styling.md | Styling package guide: colors, box environments, tables, compilation, troubleshooting |
references/goal_setting_frameworks.md | SMART and related goal-setting frameworks |
references/intervention_guidelines.md | Evidence-based intervention guidance |
references/regulatory_compliance.md | HIPAA and documentation compliance detail |
references/specialty_specific_guidelines.md | Specialty society guideline references |
references/treatment_plan_standards.md | Treatment-plan documentation standards |
Ethical Considerations
- Informed Consent: All plans should involve patient understanding and voluntary agreement to proposed interventions.
- Cultural Sensitivity: Respect diverse cultural beliefs, health practices, and communication styles.
- Health Equity: Consider social determinants of health, access barriers, and disparities.
- Privacy Protection: Maintain strict HIPAA compliance; de-identify all protected health information in shared documents.
- Autonomy and Beneficence: Balance medical recommendations with patient autonomy and values while promoting patient welfare.
License
Part of the Claude Scientific Writer project. See main LICENSE file.
What ships with it: 26 files
396.8 KB alongside SKILL.md, 4 of them executable
assets/
- chronic_disease_management_plan.tex28.7 KB
- general_medical_treatment_plan.tex22.7 KB
- medical_treatment_plan.sty5.3 KB
- mental_health_treatment_plan.tex33.7 KB
- one_page_treatment_plan.tex5.3 KB
- pain_management_plan.tex32.5 KB
- perioperative_care_plan.tex29.3 KB
- quality_checklist.md14.7 KB
- rehabilitation_treatment_plan.tex29.7 KB
- STYLING_QUICK_REFERENCE.md3.8 KB
evals/
- evals.json5.2 KB
references/
- document_formats.md12.4 KB
- goal_setting_frameworks.md16.2 KB
- intervention_guidelines.md18.6 KB
- latex_styling.md13.1 KB
- README.md2.2 KB
- regulatory_compliance.md17.2 KB
- specialty_components.md12.7 KB
- specialty_specific_guidelines.md26.1 KB
- templates_and_validation.md7.2 KB
- treatment_plan_standards.md16.3 KB
- worked_examples.md2.4 KB
scripts/
- check_completeness.pyruns9.7 KB
- generate_template.pyruns7.6 KB
- timeline_generator.pyruns12.3 KB
- validate_treatment_plan.pyruns12.1 KB
Gives 0 of the 12 instructions most plan spec skills give in ~1.6k tokens
Counted across 1,360 of the 2,617 authors here whose files we hold, read 2026-09-06
- Ask one question at a timein 73 of 1360
- Write the spec using the templatein 22 of 1360
- Ask clarifying questions if neededin 19 of 1360, across 18 files
- Wait for user confirmation before proceedingin 19 of 1360
- Save plans to the plans directoryin 17 of 1360, across 13 files
- Check for product marketing context firstin 16 of 1360, across 5 files
- Read the plan file completelyin 16 of 1360
- Order tasks by dependencyin 16 of 1360
- Gather context from the conversationin 15 of 1360, across 9 files
- Explore the codebase instead of askingin 15 of 1360, across 13 files
- Wait for explicit user approvalin 14 of 1360, across 13 files
- Quiz the user on the breakdownin 13 of 1360, across 7 files
Said here and by no other author read
- Choose format and length
- Build executive summary
- Pick specialty template
- Write SMART goals
- Apply professional styling
- Generate PDF
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.