Claude Skill

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 framew

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download AlterLab-IEU-AlterLab-Academic-Skills-skills_clinical-research_alterlab-treatment-plans-3ab6d03.zip · 150 KB

Install

skills CLI npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/clinical-research/alterlab-treatment-plans
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alterlab-ieu-alterlab-academic-skills@llmmart
Git git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alterlab-ieu/alterlab-academic-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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.

Core Principles:

  1. Concise and 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
  2. Patient-Centered: Plans must be evidence-based, measurable, and compliant with healthcare regulations (HIPAA, documentation standards)
  3. 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

Does NOT Trigger

Scenario Use Instead
Population-level treatment recommendations or guidelines with GRADE grading, or a biomarker-stratified cohort analysis alterlab-clinical-decision
Documenting care that already happened (SOAP note, H&P, discharge summary) or a journal case report alterlab-clinical-reports
Pharmacogenomic dosing guidance (CPIC/DPWG) for a gene–drug pair alterlab-clinpgx
Looking up drug properties, targets, or drug–drug interactions alterlab-drugbank

Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-clinical-decision) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.

Clinical Safety

A treatment plan is a draft for the treating clinician to review, adapt, and sign — not an order. Build it only from the patient information the user provides, and mark missing items (allergies, renal function, current medications) as blanks to complete rather than guessing, because a plausible default dose or omitted interaction check can cause harm. Check every drug, dose, and monitoring interval against current labeling and guidelines the clinician can verify, cite guideline sources the user supplied or that you retrieved in this session (WebSearch/WebFetch on the guideline body's own site, or PubMed), and never invent a citation. Include a short AI-assistance note in the document.

Core Workflow

  1. 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.
  2. 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.
  3. 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 in references/specialty_components.md.
  4. Write SMART goals (Specific, Measurable, Achievable, Relevant, Time-bound) for short- and long-term horizons.
  5. Apply professional styling with the medical_treatment_plan.sty package — see references/latex_styling.md.
  6. 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

MIT; upstream attribution is recorded in the repository's NOTICE and PROVENANCE.md.

Part of the AlterLab Academic Skills suite.

Files (alterlab-academic-skills)
  • assets
    • chronic_disease_management_plan.tex 28.7 KB · in bundle
    • general_medical_treatment_plan.tex 22.7 KB · in bundle
    • medical_treatment_plan.sty 5.5 KB · in bundle
    • mental_health_treatment_plan.tex 33.7 KB · in bundle
    • one_page_treatment_plan.tex 5.3 KB · in bundle
    • pain_management_plan.tex 32.5 KB · in bundle
    • perioperative_care_plan.tex 29.3 KB · in bundle
    • quality_checklist.md 14.7 KB
      Loading…
    • rehabilitation_treatment_plan.tex 29.7 KB · in bundle
    • STYLING_QUICK_REFERENCE.md 3.8 KB
      Loading…
  • evals
    • evals.json 5.9 KB
      Loading…
  • references
    • document_formats.md 12.4 KB
      Loading…
    • goal_setting_frameworks.md 16.2 KB
      Loading…
    • intervention_guidelines.md 18.6 KB
      Loading…
    • latex_styling.md 13.2 KB
      Loading…
    • README.md 2.2 KB
      Loading…
    • regulatory_compliance.md 17.2 KB
      Loading…
    • specialty_components.md 12.7 KB
      Loading…
    • specialty_specific_guidelines.md 26.1 KB
      Loading…
    • templates_and_validation.md 7.2 KB
      Loading…
    • treatment_plan_standards.md 16.3 KB
      Loading…
    • worked_examples.md 2.4 KB
      Loading…
  • scripts
    • check_completeness.py 9.9 KB
      Loading…
    • generate_template.py 7.6 KB
      Loading…
    • timeline_generator.py 12.3 KB
      Loading…
    • validate_treatment_plan.py 12.1 KB
      Loading…
  • SKILL.md 10.2 KB
    ---
    name: alterlab-treatment-plans
    description: 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.
    allowed-tools: Read Write Edit Bash WebSearch WebFetch
    license: MIT
    compatibility: "Runs with Read/Write/Edit/Bash; producing PDF output requires a local LaTeX toolchain (pdflatex/xelatex). No API key required."
    metadata:
        skill-author: AlterLab
        version: "1.1.0"
        last_updated: "2026-09-23"
    ---
    
    # 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.
    
    **Core Principles:**
    1. **Concise and 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
    2. **Patient-Centered**: Plans must be evidence-based, measurable, and compliant with healthcare regulations (HIPAA, documentation standards)
    3. **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
    
    ### Does NOT Trigger
    
    | Scenario | Use Instead |
    |----------|-------------|
    | Population-level treatment recommendations or guidelines with GRADE grading, or a biomarker-stratified cohort analysis | `alterlab-clinical-decision` |
    | Documenting care that already happened (SOAP note, H&P, discharge summary) or a journal case report | `alterlab-clinical-reports` |
    | Pharmacogenomic dosing guidance (CPIC/DPWG) for a gene–drug pair | `alterlab-clinpgx` |
    | Looking up drug properties, targets, or drug–drug interactions | `alterlab-drugbank` |
    
    **Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-clinical-decision`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
    
    ## Clinical Safety
    
    A treatment plan is a draft for the treating clinician to review, adapt, and sign — not an order. Build it only from the patient information the user provides, and mark missing items (allergies, renal function, current medications) as blanks to complete rather than guessing, because a plausible default dose or omitted interaction check can cause harm. Check every drug, dose, and monitoring interval against current labeling and guidelines the clinician can verify, cite guideline sources the user supplied or that you retrieved in this session (WebSearch/WebFetch on the guideline body's own site, or PubMed), and never invent a citation. Include a short AI-assistance note in the document.
    
    ## Core Workflow
    
    1. **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`.
    2. **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`.
    3. **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 in `references/specialty_components.md`.
    4. **Write SMART goals** (Specific, Measurable, Achievable, Relevant, Time-bound) for short- and long-term horizons.
    5. **Apply professional styling** with the `medical_treatment_plan.sty` package — see `references/latex_styling.md`.
    6. **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`](references/specialty_components.md)**.
    
    ## Quick Generation
    
    ```bash
    # 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`](references/latex_styling.md)**.
    
    ## Reference Index
    
    | File | Contents |
    | ---- | -------- |
    | [`references/document_formats.md`](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`](references/specialty_components.md) | Full required-component checklists for all six specialty plan types |
    | [`references/worked_examples.md`](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`](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`](references/latex_styling.md) | Styling package guide: colors, box environments, tables, compilation, troubleshooting |
    | [`references/goal_setting_frameworks.md`](references/goal_setting_frameworks.md) | SMART and related goal-setting frameworks |
    | [`references/intervention_guidelines.md`](references/intervention_guidelines.md) | Evidence-based intervention guidance |
    | [`references/regulatory_compliance.md`](references/regulatory_compliance.md) | HIPAA and documentation compliance detail |
    | [`references/specialty_specific_guidelines.md`](references/specialty_specific_guidelines.md) | Specialty society guideline references |
    | [`references/treatment_plan_standards.md`](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
    
    MIT; upstream attribution is recorded in the repository's NOTICE and PROVENANCE.md.
    
    Part of the AlterLab Academic Skills suite.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.