alterlab-treatment-plans

$npx mdskill add AlterLab-IEU/AlterLab-Academic-Skills/alterlab-treatment-plans

Generates concise, focused medical treatment plans in LaTeX/PDF format.

  • Drafts brief, actionable patient treatment plans with SMART goals.
  • Requires local LaTeX toolchain (pdflatex/xelatex) for PDF output.
  • Uses SMART goal framework and evidence-based interventions per specialty.
  • Outputs a professional, HIPAA-compliant PDF treatment plan.

SKILL.md

.github/skills/alterlab-treatment-plansView on GitHub ↗
---
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
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.0.0"
---

# 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:**
1. **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
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

## 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

Part of the Claude Scientific Writer project. See main LICENSE file.

More from AlterLab-IEU/AlterLab-Academic-Skills

SkillDescription
alterlab-abm-mesaBuilds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(seed=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions an agent-based model, Mesa, simulating interacting agents, or emergent macro behavior from micro rules. For discrete-event (queueing/process) simulation prefer alterlab-simpy; for reinforcement learning prefer alterlab-stable-baselines3. Part of the AlterLab Academic Skills suite.
alterlab-academic-careerPrepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
alterlab-accreditation-aolScaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (2020 Standard 5) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learning-outcomes set, a curriculum/outcome map or coverage matrix, a direct/indirect assessment plan, a closing-the-loop report, or accreditation self-study text. For single-course design or course rubrics prefer alterlab-teaching-design; for post-award grant reports prefer alterlab-grant-reporting. Part of the AlterLab Academic Skills suite.
alterlab-adaptyvSubmits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
alterlab-aeonRuns time series machine learning with the aeon library — classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search via scikit-learn compatible APIs. Use when working with temporal data, sequential patterns, or time-indexed observations (univariate or multivariate) that need specialized algorithms beyond standard ML approaches. Part of the AlterLab Academic Skills suite.
alterlab-akademik-tesvikComputes the annual Turkish academic-incentive (akademik teşvik) score for Devlet (state) university öğretim elemanı (academic staff) from a classified activity list, applying the verified Akademik Teşvik Ödeneği Yönetmeliği (2018/11834) Faaliyet Hesaplama Tablosu headline puanları (Proje 20, Araştırma 15, Yayın 30, Patent 30, Atıf 30, Tebliğ 20, Ödül 20) with the k (author-count), p (Q1 1/Q2 0.8/Q3 0.5/Q4 0.25), and r (project-role) coefficients via türü puanı = Σ(faaliyet oranları) × headline (MADDE 8/2), then enforcing the per-type headline ceilings, the 100 cap (MADDE 8/3), and the net-30 payment gate (MADDE 10/3) in a deterministic scripts/tesvik_score.py. Use when the user wants to calculate akademik teşvik puanı, check the en az 30 (net-30) threshold, apply TABLO 4 ceilings, or estimate teşvik eligibility; keeps its coefficients separate from doçentlik scoring. For doçentlik point eligibility prefer alterlab-docentlik-eligibility. Part of the AlterLab Academic Skills suite.
alterlab-alpha-vantageAccesses real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API (requires a free API key from alphavantage.co). Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Part of the AlterLab Academic Skills suite.
alterlab-alphafoldPredict protein 3D structures with AlphaFold2 via ColabFold — MMseqs2-accelerated MSAs, monomer and AlphaFold2-Multimer complex folding, and confidence-based validation (pLDDT, pTM/ipTM, PAE). Use when folding a protein sequence or complex from FASTA, generating a predicted structure with confidence metrics, ranking models, or checking self-consistency of a design. For co-folding a protein WITH a small-molecule ligand or predicting binding affinity prefer alterlab-boltz; for antibody–antigen or one-FASTA multi-entity complexes prefer alterlab-chai; to LOOK UP an already-computed structure prefer alterlab-alphafold-db; for ESM embeddings or inverse folding prefer alterlab-esm. Part of the AlterLab Academic Skills suite.
alterlab-alphafold-dbAccess the AlphaFold DB of 200M+ AI-PREDICTED protein structures — retrieve models by UniProt accession, download PDB/mmCIF files, and analyze prediction confidence metrics (pLDDT, PAE). Use when a UniProt ID needs a computationally predicted 3D structure or when no experimental structure exists, for homology modeling, protein engineering, or structure-based drug discovery; for EXPERIMENTALLY determined structures (X-ray, cryo-EM, NMR) prefer alterlab-pdb, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
alterlab-anndataBuild, slice, concatenate, read, and write AnnData annotated data matrices (obs, var, X, layers, obsm, uns) — the scverse data STRUCTURE, not an analysis pipeline. Use when creating or wrangling .h5ad/zarr files, managing cell and gene annotations, concatenating batches, or handling layers/obsm/backed-mode; for the QC, normalization, clustering, UMAP, and differential-expression analysis pipeline prefer alterlab-scanpy instead, and for RNA velocity from spliced/unspliced layers prefer alterlab-scvelo instead. Part of the AlterLab Academic Skills suite.