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.
npx skills add https://github.com/foryourhealth111-pixel/Vibe-Skills --skill treatment-plans
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 comprehensive 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:
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.
This skill should be used when:
⚠️ MANDATORY: Every treatment plan MUST include at least 1 AI-generated figure using the scientific-schematics skill.
This is not optional. Treatment plans benefit greatly from visual elements. Before finalizing any document:
How to generate figures:
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
The AI will automatically:
When to add schematics:
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Treatment plans come in three format options based on clinical complexity and use case:
When to use: Straightforward clinical scenarios, standard protocols, busy clinical settings
Format: Single page containing all essential treatment information in scannable sections
Required sections (all on one page):
Design principles:
Example structure:
[Patient ID/Diagnosis Box at top]
TARGET PATIENT POPULATION
Number of patients, demographics, key features
PRIMARY TREATMENT REGIMEN
• Medication 1: dose, frequency, duration
• Procedure: specific details
• Monitoring: what and when
SUPPORTIVE CARE
• Key supportive medications
RATIONALE
Brief clinical justification
MOLECULAR TARGETS / RISK FACTORS
Relevant biomarkers or risk stratification
EVIDENCE LEVEL
Guideline reference, trial data
MONITORING REQUIREMENTS
Key labs/vitals, frequency
EXPECTED CLINICAL BENEFIT
Primary endpoint, timeline
When to use: Moderate complexity, need for patient education materials, multidisciplinary coordination
Uses the Foundation Medicine first-page summary model with 2-3 additional pages of details.
When to use: Complex comorbidities, research protocols, extensive safety monitoring required
CRITICAL REQUIREMENT: All treatment plans MUST have a complete executive summary on the first page ONLY, before any table of contents or detailed sections.
Following the Foundation Medicine model for precision medicine reporting and clinical summary documents, treatment plans begin with a one-page executive summary that provides immediate access to key actionable information. This entire summary must fit on the first page.
Required First Page Structure (in order):
\begin{infobox} or \begin{patientinfo})\begin{goalbox})\begin{keybox} or \begin{infobox})\begin{warningbox} if urgent)\begin{infobox})Visual Format Requirements:
\thispagestyle{empty} to remove page numbers from first page\newpage)Example First Page Structure:
\maketitle
\thispagestyle{empty}
% Report Information Box
\begin{patientinfo}
Report Type, Date, Patient Info, Diagnosis, etc.
\end{patientinfo}
% Key Finding #1: Treatment Goals
\begin{goalbox}[Primary Treatment Goals]
• Goal 1
• Goal 2
• Goal 3
\end{goalbox}
% Key Finding #2: Main Interventions
\begin{keybox}[Core Interventions]
• Intervention 1
• Intervention 2
• Intervention 3
\end{keybox}
% Key Finding #3: Critical Monitoring (if applicable)
\begin{warningbox}[Critical Decision Points]
• Decision point 1
• Decision point 2
\end{warningbox}
\newpage
\tableofcontents % TOC on page 2
\newpage % Detailed content starts page 3
CRITICAL: Treatment plans MUST prioritize brevity and clinical relevance. Default to 3-4 pages maximum unless clinical complexity absolutely demands more detail.
Treatment plans should prioritize clarity and actionability over exhaustive detail:
Streamlining Guidelines:
The goal is professional, clinically complete documentation that respects clinicians' time while ensuring comprehensive patient care. Every section should add value; remove or condense sections that don't directly inform treatment decisions.
Use minimal, targeted citations to support clinical recommendations:
General medical treatment plans address common chronic conditions and acute medical issues requiring structured therapeutic interventions.
Patient Information (De-identified)
Diagnosis and Assessment Summary
Treatment Goals (SMART Format)
Short-term goals (1-3 months):
Long-term goals (6-12 months):
Interventions
*Pharmacological*:
*Non-pharmacological*:
*Procedural*:
Timeline and Schedule
Monitoring Parameters
Expected Outcomes
Follow-up Plan
Patient Education
Risk Mitigation
Rehabilitation plans focus on restoring function, improving mobility, and enhancing quality of life through structured therapeutic programs.
Functional Assessment
Rehabilitation Goals
*Impairment-level goals*:
*Activity-level goals*:
*Participation-level goals*:
Therapeutic Interventions
*Physical Therapy*:
*Occupational Therapy*:
*Speech-Language Pathology*:
*Other Services*:
Treatment Schedule
Progress Monitoring
Home Exercise Program
Mental health treatment plans address psychiatric conditions through integrated psychotherapeutic, pharmacological, and psychosocial interventions.
Psychiatric Assessment
Treatment Goals
*Symptom reduction*:
*Functional improvement*:
*Recovery-oriented goals*:
Therapeutic Interventions
*Psychotherapy*:
*Psychopharmacology*:
*Psychosocial Interventions*:
Safety Planning
Monitoring and Assessment
Patient and Family Education
Comprehensive long-term care plans for chronic conditions requiring ongoing monitoring, treatment adjustments, and multidisciplinary coordination.
Disease-Specific Targets
Self-Management Support
Care Coordination
Population Health Integration
Structured plans for surgical and procedural patients covering preoperative preparation, intraoperative management, and postoperative recovery.
Preoperative Assessment
Perioperative Interventions
Postoperative Care
Discharge Planning
Multimodal approaches to acute and chronic pain using evidence-based interventions and opioid-sparing strategies.
Pain Assessment
Multimodal Interventions
*Pharmacological*:
*Interventional Procedures*:
*Non-pharmacological*:
Opioid Safety (when prescribed)
Functional Goals
Treatment plans MUST be concise and focused on actionable clinical information:
ALWAYS create a one-page executive summary as the first page:
All treatment goals should meet SMART criteria:
✓ Shared Decision-Making: Involve patients in goal-setting and treatment choices
✓ Cultural Competence: Respect cultural beliefs, language preferences, health literacy
✓ Patient Preferences: Honor treatment preferences and personal values
✓ Individualization: Tailor plans to patient's unique circumstances
✓ Empowerment: Support patient activation and self-management
✓ Clinical Guidelines: Follow current specialty society recommendations
✓ Quality Measures: Incorporate HEDIS, CMS quality measures
✓ Comparative Effectiveness: Use treatments with proven efficacy
✓ Avoid Low-Value Care: Eliminate unnecessary tests and interventions
✓ Stay Current: Update plans based on emerging evidence
✓ Completeness: Include all required elements
✓ Clarity: Use clear, professional medical language
✓ Accuracy: Ensure factual correctness and current information
✓ Timeliness: Document plans promptly
✓ Legibility: Professional formatting and organization
✓ Signature and Date: Authenticate all treatment plans
✓ HIPAA Privacy: De-identify all protected health information
✓ Informed Consent: Document patient understanding and agreement
✓ Billing Support: Include documentation to support medical necessity
✓ Quality Reporting: Enable extraction of quality metrics
✓ Legal Protection: Maintain defensible clinical documentation
✓ Team Communication: Share plans across care team
✓ Role Clarity: Define responsibilities for each team member
✓ Care Transitions: Ensure continuity across settings
✓ Specialist Integration: Coordinate with subspecialty care
✓ Patient-Centered Medical Home: Align with PCMH principles
Choose the appropriate template based on clinical context and desired length:
Use only when one-page format is insufficient due to complexity:
Note: Even when using standard templates, adapt them to be concise (3-4 pages max) by removing non-essential sections.
All LaTeX templates include:
# Compile LaTeX template to PDF
pdflatex general_medical_treatment_plan.tex
# For templates with references
pdflatex treatment_plan.tex
bibtex treatment_plan
pdflatex treatment_plan.tex
pdflatex treatment_plan.tex
Use validation scripts to ensure all required sections are present:
python check_completeness.py my_treatment_plan.tex
The script checks for:
Comprehensive validation of treatment plan quality:
python validate_treatment_plan.py my_treatment_plan.tex
Validation includes:
Review treatment plans against the quality checklist (quality_checklist.md):
Clinical Quality
Patient-Centered Care
Regulatory Compliance
Coordination and Communication
Treatment plans often accompany other clinical documentation:
clinical-reports skill): Document ongoing implementationclinical-reports skill): Initial assessment informs treatment planclinical-reports skill): Summarize treatment plan executionEvidence-based treatment planning requires literature support:
citation-management skill): Reference clinical guidelinesliterature-review skill): Understand treatment evidence baseresearch-lookup skill): Find current best practicesTreatment plans may be developed for clinical trials or research studies:
research-grants skill): Treatment protocols for funded studiesclinical-reports skill): Intervention documentationScenario: 58-year-old patient with newly diagnosed Type 2 diabetes, HbA1c 8.5%, BMI 32
Template: general_medical_treatment_plan.tex
Goals:
Interventions:
Scenario: 70-year-old patient s/p left MCA stroke with right hemiparesis
Template: rehabilitation_treatment_plan.tex
Goals:
Interventions:
Scenario: 35-year-old with moderate depression, PHQ-9 score 16
Template: mental_health_treatment_plan.tex
Goals:
Interventions:
Scenario: 68-year-old scheduled for right TKA for osteoarthritis
Template: perioperative_care_plan.tex
Preoperative Goals:
Postoperative Goals:
Scenario: 45-year-old with chronic non-specific low back pain, pain 7/10
Template: pain_management_plan.tex
Goals:
Interventions:
Treatment plans should align with:
Use the timeline generator script to create visual treatment timelines:
python timeline_generator.py --plan my_treatment_plan.tex --output timeline.pdf
Generates:
Interactive template selection:
cd .claude/skills/treatment-plans/scripts
python generate_template.py
# Or specify type directly
python generate_template.py --type mental_health --output depression_treatment_plan.tex
python check_completeness.py plan.texpython validate_treatment_plan.py plan.texquality_checklist.mdpdflatex plan.texTreatment plans can be enhanced with professional medical document styling using the medical_treatment_plan.sty LaTeX package. This custom style transforms plain academic documents into visually appealing, color-coded clinical documents that maintain scientific rigor while improving readability and usability.
The medical_treatment_plan.sty package (located in assets/medical_treatment_plan.sty) provides:
Professional Color Scheme
Styled Elements
The style package includes five specialized box environments for organizing clinical information:
For general information, clinical assessments, and testing schedules:
\begin{infobox}[Title]
\textbf{Key Information:}
\begin{itemize}
\item Clinical assessment details
\item Testing schedules
\item General guidance
\end{itemize}
\end{infobox}
Use cases: Metabolic status, baseline assessments, monitoring schedules, titration protocols
For critical decision points, safety protocols, and alerts:
\begin{warningbox}[Alert Title]
\textbf{Important Safety Information:}
\begin{itemize}
\item Critical drug interactions
\item Safety monitoring requirements
\item Red flag symptoms requiring immediate action
\end{itemize}
\end{warningbox}
Use cases: Medication safety, decision points, contraindications, emergency protocols
For treatment goals, targets, and success criteria:
\begin{goalbox}[Treatment Goals]
\textbf{Primary Objectives:}
\begin{itemize}
\item Reduce HbA1c to <7\% within 3 months
\item Achieve 5-7\% weight loss in 12 weeks
\item Complete diabetes education program
\end{itemize}
\end{goalbox}
Use cases: SMART goals, target outcomes, success metrics, CGM goals
For executive summaries, key takeaways, and important recommendations:
\begin{keybox}[Key Highlights]
\textbf{Essential Points:}
\begin{itemize}
\item Main therapeutic approach
\item Critical patient instructions
\item Priority interventions
\end{itemize}
\end{keybox}
Use cases: Plan overview, plate method instructions, important dietary guidelines
For emergency contacts and urgent protocols:
\begin{emergencybox}
\begin{itemize}
\item \textbf{Emergency Services:} 911
\item \textbf{Endocrinology Office:} [Phone] (business hours)
\item \textbf{After-Hours Hotline:} [Phone] (nights/weekends)
\item \textbf{Pharmacy:} [Phone and location]
\end{itemize}
\end{emergencybox}
Use cases: Emergency contacts, critical hotlines, urgent resource information
For patient demographics and baseline information:
\begin{patientinfo}
\begin{tabular}{ll}
\textbf{Age:} & 23 years \\
\textbf{Sex:} & Male \\
\textbf{Diagnosis:} & Type 2 Diabetes Mellitus \\
\textbf{Plan Start Date:} & \today \\
\end{tabular}
\end{patientinfo}
Use cases: Patient information sections, demographic data
Enhanced table environment with medical styling:
\begin{medtable}{Caption Text}
\begin{tabular}{|p{5cm}|p{4cm}|p{4.5cm}|}
\hline
\tableheadercolor % Blue header with white text
\textcolor{white}{\textbf{Column 1}} &
\textcolor{white}{\textbf{Column 2}} &
\textcolor{white}{\textbf{Column 3}} \\
\hline
Data row 1 content & Value 1 & Details 1 \\
\hline
\tablerowcolor % Alternating light gray row
Data row 2 content & Value 2 & Details 2 \\
\hline
Data row 3 content & Value 3 & Details 3 \\
\hline
\end{tabular}
\caption{Table caption}
\end{medtable}
Features:
\tablerowcolor) for improved readability% !TEX program = xelatex
\documentclass[11pt,letterpaper]{article}
% Use custom medical treatment plan style
\usepackage{medical_treatment_plan}
\usepackage{natbib}
\begin{document}
\maketitle
% Your content here
\end{document}
.tex file, or install to LaTeX pathxelatex treatment_plan.tex
bibtex treatment_plan
xelatex treatment_plan.tex
xelatex treatment_plan.tex
The package automatically formats the title with a professional blue header:
\title{\textbf{Individualized Diabetes Treatment Plan}\\
\large{23-Year-Old Male Patient with Type 2 Diabetes}}
\author{Comprehensive Care Plan}
\date{\today}
\begin{document}
\maketitle
This creates an eye-catching blue box with white text and clear hierarchy.
Required LaTeX Packages (automatically loaded by the style):
geometry - Page layout and marginsxcolor - Color supporttcolorbox with [most] library - Custom colored boxestikz - Graphics and drawingfontspec - Font management (XeLaTeX/LuaLaTeX)fancyhdr - Custom headers and footerstitlesec - Section stylingenumitem - Enhanced list formattingbooktabs - Professional table ruleslongtable - Multi-page tablesarray - Enhanced table featurescolortbl - Colored table cellshyperref - Hyperlinks and PDF metadatanatbib - Bibliography managementRecommended Compilation:
# Using XeLaTeX (best font support)
xelatex document.tex
bibtex document
xelatex document.tex
xelatex document.tex
# Using PDFLaTeX (alternative)
pdflatex document.tex
bibtex document
pdflatex document.tex
pdflatex document.tex
Edit the style file to modify the color scheme:
% In medical_treatment_plan.sty
\definecolor{primaryblue}{RGB}{0, 102, 153} % Modify these
\definecolor{secondaryblue}{RGB}{102, 178, 204}
\definecolor{accentblue}{RGB}{0, 153, 204}
\definecolor{successgreen}{RGB}{0, 153, 76}
\definecolor{warningred}{RGB}{204, 0, 0}
Modify geometry settings in the style file:
\RequirePackage[margin=1in, top=1.2in, bottom=1.2in]{geometry}
Uncomment and modify in the style file:
\setmainfont{Your Preferred Font}
\setsansfont{Your Sans-Serif Font}
Modify in the style file:
\fancyhead[L]{\color{primaryblue}\sffamily\small\textbf{Treatment Plan Title}}
\fancyhead[R]{\color{darkgray}\sffamily\small Patient Info}
Copy assets/medical_treatment_plan.sty to the same directory as your .tex file.
# Find your local texmf directory
kpsewhich -var-value TEXMFHOME
# Copy to appropriate location (usually ~/texmf/tex/latex/)
mkdir -p ~/texmf/tex/latex/medical_treatment_plan
cp assets/medical_treatment_plan.sty ~/texmf/tex/latex/medical_treatment_plan/
# Update TeX file database
texhash ~/texmf
# Copy to system texmf directory (requires sudo)
sudo cp assets/medical_treatment_plan.sty /usr/local/texlive/texmf-local/tex/latex/
sudo texhash
Other medical/clinical document styles available from CTAN:
Journal Styles:
# Install via TeX Live Manager
tlmgr install nejm # New England Journal of Medicine
tlmgr install jama # JAMA style
tlmgr install bmj # British Medical Journal
General Professional Styles:
tlmgr install apa7 # APA 7th edition (health sciences)
tlmgr install IEEEtran # IEEE (medical devices/engineering)
tlmgr install springer # Springer journals
Download from CTAN:
Issue: Package not found
# Install missing packages via TeX Live Manager
sudo tlmgr update --self
sudo tlmgr install tcolorbox tikz pgf
Issue: Missing characters (✓, ≥, etc.)
$\checkmark$, $\geq$amssymb package for math symbolsIssue: Header height warnings
\setlength{\headheight}{22pt}Issue: Boxes not rendering
# Ensure complete tcolorbox installation
sudo tlmgr install tcolorbox tikz pgf
Issue: Font not found (XeLaTeX)
\textcolor{primaryblue}{\textbf{Text}} for emphasis\vspace{0.5cm} between major sections\tableheadercolor for all header rows\tablerowcolor to alternating rows in tables >3 rows\small\sffamily for large tables% !TEX program = xelatex
\documentclass[11pt,letterpaper]{article}
\usepackage{medical_treatment_plan}
\usepackage{natbib}
\title{\textbf{Comprehensive Treatment Plan}\\
\large{Patient-Centered Care Strategy}}
\author{Multidisciplinary Care Team}
\date{\today}
\begin{document}
\maketitle
\section*{Patient Information}
\begin{patientinfo}
% Demographics table
\end{patientinfo}
\section{Executive Summary}
\begin{keybox}[Plan Overview]
% Key highlights
\end{keybox}
\section{Treatment Goals}
\begin{goalbox}[SMART Goals - 3 Months]
\begin{medtable}{Primary Treatment Targets}
% Goals table with colored headers
\end{medtable}
\end{goalbox}
\section{Medication Plan}
\begin{infobox}[Titration Schedule]
% Medication instructions
\end{infobox}
\begin{warningbox}[Critical Decision Point]
% Important safety information
\end{warningbox}
\section{Emergency Protocols}
\begin{emergencybox}
% Emergency contacts
\end{emergencybox}
\bibliographystyle{plainnat}
\bibliography{references}
\end{document}
Clinical Practice:
Educational Use:
Documentation Quality:
Patient Engagement:
All treatment plans should involve patient understanding and voluntary agreement to proposed interventions.
Treatment plans must respect diverse cultural beliefs, health practices, and communication styles.
Consider social determinants of health, access barriers, and health disparities when developing plans.
Maintain strict HIPAA compliance; de-identify all protected health information in shared documents.
Balance medical recommendations with patient autonomy and values while promoting patient welfare.
Part of the Claude Scientific Writer project. See main LICENSE file.
Searches across your Notion workspace, synthesizes findings from multiple pages, and creates comprehensive research documentation saved as new Notion pages. Turns scattered information into structured reports with proper citations and actionable insights.
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.
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.
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.
【强制】所有技术文档查询必须使用本技能,禁止在主对话中直接使用 mcp__context7-mcp 工具。触发关键词:查询/学习/了解某个库或框架的文档、API用法、配置参数、错误解释、版本差异、代码示例、最佳实践。本技能通过 context7-researcher agent 执行查询,避免大量文档内容污染主对话上下文,保持 token 效率。
Generates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
Maximum-saturation research orchestration: ALWAYS proposes the final materials first (PDF+DOCX default), then parallel explore+librarian swarms across codebase, web, official docs, and OSS repos — max-roster teammode when the harness has it — with live journaling, a recursive EXPAND loop driven by leads workers return in message text, empirical verification by running code, and a cited synthesis with charts/Mermaid/assets behind a mandatory visual-QA gate. ACTIVATES ONLY on an explicit user demand for research — the word 'ulw-research' ('/ulw-research', '$ulw-research'), any 'ulw' research wording, 'ultradebate' or 'hyperdebate' research requests, or an explicit request for research / deep research / an ultra-precise investigation, in any language. Never self-activates for ordinary questions, debugging, or implementation context-gathering. While active it overrides exploration-bounding defaults: exhaustive coverage is the goal.
"Solve competition math problems (IMO, Putnam, USAMO, AIME) with adversarial verification that catches the errors self-verification misses. Activates when asked to 'solve this IMO problem', 'prove this olympiad inequality', 'verify this competition proof', 'find a counterexample', 'is this proof correct', or for any problem with 'IMO', 'Putnam', 'USAMO', 'olympiad', or 'competition math' in it. Uses pure reasoning (no tools) — then a fresh-context adversarial verifier attacks the proof using specific failure patterns, not generic 'check logic'. Outputs calibrated confidence — will say 'no confident solution' rather than bluff. If LaTeX is available, produces a clean PDF after verification passes."
Take foryourhealth111-pixel/treatment-plans from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.