treatment-plans▌
davila7/claude-code-templates · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
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.
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 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:
- CONCISE & ACTIONABLE: Treatment plans default to 3-4 pages maximum, 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 to support clinical recommendations; avoid extensive bibliographies
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
This skill should be used when:
- Creating individualized treatment plans for patient care
- Documenting therapeutic interventions for chronic disease management
- Developing rehabilitation programs (physical therapy, occupational therapy, cardiac rehab)
- 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
- Generating professional treatment plans for medical records
Visual Enhancement with Scientific Schematics
⚠️ 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:
- Generate at minimum ONE schematic or diagram (e.g., treatment pathway flowchart, care coordination diagram, or therapy timeline)
- For complex plans: include decision algorithm flowchart
- For rehabilitation plans: include milestone progression diagram
How to generate figures:
- Use the scientific-schematics skill to generate AI-powered publication-quality diagrams
- Simply describe your desired diagram in natural language
- Nano Banana Pro will automatically generate, review, and refine the schematic
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
The AI will automatically:
- Create publication-quality images with proper formatting
- Review and refine through multiple iterations
- Ensure accessibility (colorblind-friendly, high contrast)
- Save outputs in the figures/ directory
When to add schematics:
- Treatment pathway flowcharts
- Care coordination diagrams
- Therapy progression timelines
- Multidisciplinary team interaction diagrams
- Medication management flowcharts
- Rehabilitation protocol visualizations
- Clinical decision algorithm diagrams
- Any complex concept that benefits from visualization
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Document Format and Best Practices
Document Length Options
Treatment plans come in three format options based on clinical complexity and use case:
Option 1: One-Page Treatment Plan (PREFERRED for most cases)
When to use: Straightforward clinical scenarios, standard protocols, busy clinical settings
Format: Single page containing all essential treatment information in scannable sections
- No table of contents needed
- No extensive narratives
- Focused on actionable items only
- Similar to precision oncology reports or treatment recommendation cards
Required sections (all on one page):
- Header Box: Patient info, diagnosis, date, molecular/risk profile if applicable
- Treatment Regimen: Numbered list of specific interventions
- Supportive Care: Brief bullet points
- Rationale: 1-2 sentence justification (optional for standard protocols)
- Monitoring: Key parameters and frequency
- Evidence Level: Guideline reference or evidence grade (e.g., "Level 1, FDA approved")
- Expected Outcome: Timeline and success metrics
Design principles:
- Use small boxes/tables for organization (like the clinical treatment recommendation card format)
- Eliminate all non-essential text
- Use abbreviations familiar to clinicians
- Dense information layout - maximize information per square inch
- Think "quick reference card" not "comprehensive documentation"
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
Option 2: Standard 3-4 Page Format
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.
Option 3: Extended 5-6 Page Format
When to use: Complex comorbidities, research protocols, extensive safety monitoring required
First Page Summary (Foundation Medicine Model)
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):
-
Title and Subtitle
- Main title: Treatment plan type (e.g., "Comprehensive Treatment Plan")
- Subtitle: Specific condition or focus (e.g., "Type 2 Diabetes Mellitus - Young Adult Patient")
-
Report Information Box (using
\begin{infobox}or\begin{patientinfo})- Report type/document purpose
- Date of plan creation
- Patient demographics (age, sex, de-identified)
- Primary diagnosis with ICD-10 code
- Report author/clinic (if applicable)
- Analysis approach or framework used
-
Key Findings or Treatment Highlights (2-4 colored boxes using appropriate box types)
- Primary Treatment Goals (using
\begin{goalbox})- 2-3 SMART goals in bullet format
- Main Interventions (using
\begin{keybox}or\begin{infobox})- 2-3 key interventions (pharmacological, non-pharmacological, monitoring)
- Critical Decision Points (using
\begin{warningbox}if urgent)- Important monitoring thresholds or safety considerations
- Timeline Overview (using
\begin{infobox})- Brief treatment duration/phases
- Key milestone dates
- Primary Treatment Goals (using
Visual Format Requirements:
- Use
\thispagestyle{empty}to remove page numbers from first page - All content must fit on page 1 (before
\newpage) - Use colored boxes (tcolorbox package) with different colors for different information types
- Boxes should be visually prominent and easy to scan
- Use concise, bullet-point format
- Table of contents (if included) starts on page 2
- Detailed sections start on page 3
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
Concise Documentation
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:
- Focused: Include only clinically essential information that impacts care decisions
- Actionable: Emphasize what needs to be done, when, and why
- Efficient: Facilitate quick decision-making without sacrificing clinical quality
- Target length options:
- 1-page format (preferred for straightforward cases): Quick-reference card with all essential information
- 3-4 pages standard: Standard format with first-page summary + supporting details
- 5-6 pages (rare): Only for highly complex cases with multiple comorbidities or multidisciplinary interventions
Streamlining Guidelines:
- First Page Summary: Use individual colored boxes to consolidate key information (goals, interventions, decision points) - this alone can often convey the essential treatment plan
- Eliminate Redundancy: If information is in the first-page summary, don't repeat it verbatim in detailed sections
- Patient Education section: 3-5 key bullet points on critical topics and warning signs only
- Risk Mitigation section: Highlight only critical medication safety concerns and emergency actions (not exhaustive lists)
- Expected Outcomes section: 2-3 concise statements on anticipated responses and timelines
- Interventions: Focus on primary interventions; secondary/supportive measures in brief bullet format
- Use tables and bullet points extensively for efficient presentation
- Avoid narrative prose where structured lists suffice
- Combine related sections when appropriate to reduce page count
Quality Over Quantity
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.
Citations and Evidence Support
Use minimal, targeted citations to support clinical recommendations:
- Text Citations Preferred: Use brief in-text citations (Author Year) or simple references rather than extensive bibliographies unless specifically requested
- When to Cite:
- Clinical practice guideline recommendations (e.g., "per ADA 2024 guidelines")
- Specific medication dosing or protocols (e.g., "ACC/AHA recommendations")
- Novel or controversial interventions requiring evidence support
- Risk stratification tools or validated assessment scales
- When NOT to Cite:
- Standard-of-care interventions widely accepted in the field
- Basic medical facts and routine clinical practices
- General patient education content
- Citation Format:
- Inline: "Initiate metformin as first-line therapy (ADA Standards of Care 2024)"
- Minimal: "Treatment follows ACC/AHA heart failure guidelines"
- Avoid formal numbered references and extensive bibliography sections unless document is for academic/research purposes
- Keep it Brief: A 3-4 page treatment plan should have 0-3 citations maximum, only where essential for clinical credibility or novel recommendations
Core Capabilities
1. General Medical Treatment Plans
General medical treatment plans address common chronic conditions and acute medical issues requiring structured therapeutic interventions.
Standard Components
Patient Information (De-identified)
- Demographics (age, sex, relevant medical background)
- Active medical conditions and comorbidities
- Current medications and allergies
- Relevant social and family history
- Functional status and baseline assessments
- HIPAA Compliance: Remove all 18 identifiers per Safe Harbor method
Diagnosis and Assessment Summary
- Primary diagnosis with ICD-10 code
- Secondary diagnoses and comorbidities
- Severity classification and staging
- Functional limitations and quality of life impact
- Risk stratification (e.g., cardiovascular risk, fall risk)
- Prognostic indicators
Treatment Goals (SMART Format)
Short-term goals (1-3 months):
- Specific: Clearly defined outcome (e.g., "Reduce HbA1c to <7%")
- Measurable: Quantifiable metrics (e.g., "Decrease systolic BP by 10 mmHg")
- Achievable: Realistic given patient capabilities
- Relevant: Aligned with patient priorities and values
- Time-bound: Specific timeframe (e.g., "within 8 weeks")
Long-term goals (6-12 months):
- Disease control or remission targets
- Functional improvement objectives
- Quality of life enhancement
- Prevention of complications
- Maintenance of independence
Interventions
Pharmacological:
- Medications with specific dosages, routes, frequencies
- Titration schedules and target doses
- Drug-drug interaction considerations
- Monitoring for adverse effects
- Medication reconciliation
Non-pharmacological:
- Lifestyle modifications (diet, exercise, smoking cessation)
- Behavioral interventions
- Patient education and self-management
- Monitoring and self-tracking (glucose, blood pressure, weight)
- Assistive devices or adaptive equipment
Procedural:
- Planned procedures or interventions
- Referrals to specialists
- Diagnostic testing schedule
- Preventive care (vaccinations, screenings)
Timeline and Schedule
- Treatment phases with specific timeframes
- Appointment frequency (weekly, monthly, quarterly)
- Milestone assessments and goal evaluations
- Medication adjustments schedule
- Expected duration of treatment
Monitoring Parameters
- Clinical outcomes to track (vital signs, lab values, symptoms)
- Assessment tools and scales (e.g., PHQ-9, pain scales)
- Frequency of monitoring
- Thresholds for intervention or escalation
- Patient-reported outcomes
Expected Outcomes
- Primary outcome measures
- Success criteria and benchmarks
- Expected timeline for improvement
- Criteria for treatment modification
- Long-term prognosis
Follow-up Plan
- Scheduled appointments and reassessments
- Communication plan (phone calls, secure messaging)
- Emergency contact procedures
- Criteria for urgent evaluation
- Transition or discharge planning
Patient Education
- Understanding of condition and treatment rationale
- Self-management skills training
- Medication administration and adherence
- Warning signs and when to seek help
- Resources and support services
Risk Mitigation
- Potential adverse effects and management
- Drug interactions and contraindications
- Fall prevention, infection prevention
- Emergency action plans
- Safety monitoring
Common Applications
- Diabetes mellitus management
- Hypertension control
- Heart failure treatment
- COPD management
- Asthma care plans
- Hyperlipidemia treatment
- Osteoarthritis management
- Chronic kidney disease
2. Rehabilitation Treatment Plans
Rehabilitation plans focus on restoring function, improving mobility, and enhancing quality of life through structured therapeutic programs.
Core Components
Functional Assessment
- Baseline functional status (ADLs, IADLs)
- Range of motion, strength, balance, endurance
- Gait analysis and mobility assessment
- Standardized measures (FIM, Barthel Index, Berg Balance Scale)
- Environmental assessment (home safety, accessibility)
Rehabilitation Goals
Impairment-level goals:
- Improve shoulder flexion to 140 degrees
- Increase quadriceps strength by 2/5 MMT grades
- Enhance balance (Berg Score >45/56)
Activity-level goals:
- Independent ambulation 150 feet with assistive device
- Climb 12 stairs with handrail supervision
- Transfer bed-to-chair independently
Participation-level goals:
- Return to work with modifications
- Resume recreational activ
How to use treatment-plans on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add treatment-plans
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches treatment-plans from GitHub repository davila7/claude-code-templates and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate treatment-plans. Access the skill through slash commands (e.g., /treatment-plans) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
Make data-driven prioritization decisions faster
Stakeholder Communication
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client
- ›Access to product documentation and roadmap tools (Jira, Notion, etc.)
- ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
- ›Stakeholder contact information and communication channels
Time Estimate
30-60 minutes to see productivity improvements
Installation Steps
- 1.Install product management skill
- 2.Start with user story generation for known feature
- 3.Progress to competitive analysis: research 2-3 competitors
- 4.Use for roadmap prioritization: apply RICE/ICE scoring
- 5.Draft stakeholder communications and refine based on feedback
- 6.Build template library for recurring PM tasks
- 7.Share effective prompts with product team
Common Pitfalls
- ⚠Not validating competitive research—verify facts before sharing
- ⚠Accepting user stories without involving engineering team
- ⚠Over-relying on frameworks without qualitative judgment
- ⚠Not customizing outputs to company culture and communication style
- ⚠Skipping stakeholder validation of generated requirements
Best Practices▌
✓ Do
- +Validate research and competitive analysis with real data
- +Collaborate with engineering when generating technical requirements
- +Customize frameworks and templates to your company context
- +Use skill for first drafts, refine with stakeholder input
- +Document successful prompt patterns for PM tasks
- +Combine AI efficiency with human judgment and intuition
✗ Don't
- −Don't publish competitive analysis without fact-checking
- −Don't finalize user stories without engineering review
- −Don't make prioritization decisions solely on AI scoring
- −Don't skip customer validation of generated requirements
- −Don't ignore company-specific context and culture
💡 Pro Tips
- ★Provide context: company goals, constraints, customer feedback
- ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
- ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
- ★Use skill for 70% generation + 30% customization to company needs
When to Use This▌
✓ Use When
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid When
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
Learning Path▌
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★28 reviews- ★★★★★Emma Kim· Dec 24, 2024
I recommend treatment-plans for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Layla Perez· Dec 20, 2024
treatment-plans has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Yuki Jain· Dec 20, 2024
Useful defaults in treatment-plans — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★James Yang· Nov 15, 2024
Keeps context tight: treatment-plans is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Kofi White· Nov 11, 2024
treatment-plans is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★James Haddad· Oct 6, 2024
treatment-plans is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Hiroshi Ghosh· Oct 2, 2024
Keeps context tight: treatment-plans is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Rahul Santra· Sep 13, 2024
We added treatment-plans from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Pratham Ware· Aug 4, 2024
treatment-plans fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yash Thakker· Jul 23, 2024
Registry listing for treatment-plans matched our evaluation — installs cleanly and behaves as described in the markdown.
showing 1-10 of 28