SOAP Note Creation
This skill provides a reusable pattern for creating structured medical documentation (SOAP notes) by writing all required sections comprehensively in a single file write operation.
When to Use
- Creating clinical documentation for patient visits
- Generate structured medical notes requiring standard SOAP format
- Tasks requiring Subjective, Objective, Assessment, and Plan sections
Core Pattern
Write the complete SOAP note directly to a file in one iteration rather than building it incrementally. Include all four standard sections with comprehensive content.
SOAP Note Structure
1. Subjective (S)
Document patient-reported information:
- Chief Complaint (CC): Primary reason for visit in patient's own words
- History of Present Illness (HPI): Detailed narrative of current symptoms (onset, duration, severity, modifying factors)
- Past Medical History (PMH): Chronic conditions, surgeries, hospitalizations
- Medications: Current prescriptions, OTC drugs, supplements
- Allergies: Drug, food, environmental allergies with reactions
- Family History: Relevant hereditary conditions in family members
- Social History: Occupation, lifestyle, substance use, living situation
2. Objective (O)
Document observable, measurable findings:
- Vital Signs: BP, HR, RR, Temp, SpO2, height, weight, BMI
- General Appearance: Overall presentation, distress level
- Physical Exam by System:
- HEENT (Head, Eyes, Ears, Nose, Throat)
- Cardiovascular
- Respiratory
- Gastrointestinal
- Neurological
- Musculoskeletal
- Skin
- Psychiatric (if applicable)
- Diagnostic Results: Labs, imaging, tests (if available)
3. Assessment (A)
Document clinical reasoning:
- Primary Diagnosis: Main working diagnosis with ICD code if applicable
- Differential Diagnoses: Alternative diagnoses considered
- Clinical Reasoning: Why the primary diagnosis is most likely
- Problem List: Numbered or bulleted active issues
4. Plan (P)
Document management strategy:
- Treatment Plan: Medications, therapies, procedures
- Follow-up: Timing and purpose of next visit
- Patient Education: Counseling provided, instructions given
- Referrals: Specialist consultations if needed
- Order Set: Labs, imaging, tests to be obtained
Implementation Template
# SOAP Note - [Patient Name/ID]
**Date:** [Date of Visit]
**Provider:** [Provider Name]
## Subjective
### Chief Complaint
[Patient's stated reason for visit]
### History of Present Illness
[Detailed narrative of symptoms using OLDCARTS or similar framework]
### Past Medical History
[List of relevant conditions]
### Medications
[List with dosages]
### Allergies
[List with reactions]
### Family History
[Relevant family medical conditions]
### Social History
[Occupation, habits, lifestyle factors]
## Objective
### Vital Signs
- BP: [value]
- HR: [value]
- RR: [value]
- Temp: [value]
- SpO2: [value]
- Height: [value]
- Weight: [value]
- BMI: [value]
### Physical Examination
**General:** [Appearance, distress level]
**HEENT:** [Findings]
**Cardiovascular:** [Findings]
**Respiratory:** [Findings]
**Gastrointestinal:** [Findings]
**Neurological:** [Findings]
**Musculoskeletal:** [Findings]
**Skin:** [Findings]
### Diagnostic Results
[List any available lab/imaging results]
## Assessment
1. **[Primary Diagnosis]** - [ICD-10 code if applicable]
- [Brief justification]
2. **[Differential Diagnosis]** - [Why less likely]
### Problem List
1. [Active problem 1]
2. [Active problem 2]
## Plan
### Treatment
- [Medication/dosage/frequency]
- [Non-pharmacologic interventions]
### Follow-up
- [Timeline and purpose]
### Patient Education
- [Topics discussed]
- [Instructions provided]
### Orders/Referrals
- [Labs/imaging ordered]
- [Specialist referrals]
Best Practices
- Write comprehensively in one pass - Gather all information first, then write the complete note
- Use clear section headers - Make each SOAP component easily identifiable
- Include specific details - Avoid vague statements; use measurable data
- Maintain professional tone - Use appropriate medical terminology
- Ensure logical flow - Assessment should follow from Objective findings; Plan should address Assessment
- Document negative findings - Note relevant systems reviewed that were normal
- Include patient understanding - Document that patient understood the plan
Example Usage
When tasked with creating a SOAP note:
- Gather all available patient information from the task description
- Organize information into SOAP categories mentally or in notes
- Write the complete file with all four sections in one
write_file operation
- Ensure no required section is missing before completing the task
File Format
- Use markdown (.md) or plain text (.txt) for clarity
- Include appropriate headers for each section
- Use bullet points and numbered lists for readability
- Keep file size comprehensive (typically 3000-10000+ bytes for complete notes)
1---2name: soap-note-creation-b354d83description: Create structured medical SOAP notes by writing comprehensive content to a file in one iteration4---5
6# SOAP Note Creation
7
8This skill provides a reusable pattern for creating structured medical documentation (SOAP notes) by writing all required sections comprehensively in a single file write operation.
9
10## When to Use
11
12- Creating clinical documentation for patient visits
13- Generate structured medical notes requiring standard SOAP format
14- Tasks requiring Subjective, Objective, Assessment, and Plan sections
15
16## Core Pattern
17
18**Write the complete SOAP note directly to a file in one iteration** rather than building it incrementally. Include all four standard sections with comprehensive content.
19
20## SOAP Note Structure
21
22### 1. Subjective (S)
23Document patient-reported information:
24- **Chief Complaint (CC)**: Primary reason for visit in patient's own words
25- **History of Present Illness (HPI)**: Detailed narrative of current symptoms (onset, duration, severity, modifying factors)
26- **Past Medical History (PMH)**: Chronic conditions, surgeries, hospitalizations
27- **Medications**: Current prescriptions, OTC drugs, supplements
28- **Allergies**: Drug, food, environmental allergies with reactions
29- **Family History**: Relevant hereditary conditions in family members
30- **Social History**: Occupation, lifestyle, substance use, living situation
31
32### 2. Objective (O)
33Document observable, measurable findings:
34- **Vital Signs**: BP, HR, RR, Temp, SpO2, height, weight, BMI
35- **General Appearance**: Overall presentation, distress level
36- **Physical Exam by System**:
37 - HEENT (Head, Eyes, Ears, Nose, Throat)
38 - Cardiovascular
39 - Respiratory
40 - Gastrointestinal
41 - Neurological
42 - Musculoskeletal
43 - Skin
44 - Psychiatric (if applicable)
45- **Diagnostic Results**: Labs, imaging, tests (if available)
46
47### 3. Assessment (A)
48Document clinical reasoning:
49- **Primary Diagnosis**: Main working diagnosis with ICD code if applicable
50- **Differential Diagnoses**: Alternative diagnoses considered
51- **Clinical Reasoning**: Why the primary diagnosis is most likely
52- **Problem List**: Numbered or bulleted active issues
53
54### 4. Plan (P)
55Document management strategy:
56- **Treatment Plan**: Medications, therapies, procedures
57- **Follow-up**: Timing and purpose of next visit
58- **Patient Education**: Counseling provided, instructions given
59- **Referrals**: Specialist consultations if needed
60- **Order Set**: Labs, imaging, tests to be obtained
61
62## Implementation Template
63
64```markdown
65# SOAP Note - [Patient Name/ID]
66**Date:** [Date of Visit]
67**Provider:** [Provider Name]
68
69## Subjective
70
71### Chief Complaint
72[Patient's stated reason for visit]
73
74### History of Present Illness
75[Detailed narrative of symptoms using OLDCARTS or similar framework]
76
77### Past Medical History
78[List of relevant conditions]
79
80### Medications
81[List with dosages]
82
83### Allergies
84[List with reactions]
85
86### Family History
87[Relevant family medical conditions]
88
89### Social History
90[Occupation, habits, lifestyle factors]
91
92## Objective
93
94### Vital Signs
95- BP: [value]
96- HR: [value]
97- RR: [value]
98- Temp: [value]
99- SpO2: [value]
100- Height: [value]
101- Weight: [value]
102- BMI: [value]
103
104### Physical Examination
105**General:** [Appearance, distress level]
106**HEENT:** [Findings]
107**Cardiovascular:** [Findings]
108**Respiratory:** [Findings]
109**Gastrointestinal:** [Findings]
110**Neurological:** [Findings]
111**Musculoskeletal:** [Findings]
112**Skin:** [Findings]
113
114### Diagnostic Results
115[List any available lab/imaging results]
116
117## Assessment
118
1191. **[Primary Diagnosis]** - [ICD-10 code if applicable]
120 - [Brief justification]
121
1222. **[Differential Diagnosis]** - [Why less likely]
123
124### Problem List
1251. [Active problem 1]
1262. [Active problem 2]
127
128## Plan
129
130### Treatment
131- [Medication/dosage/frequency]
132- [Non-pharmacologic interventions]
133
134### Follow-up
135- [Timeline and purpose]
136
137### Patient Education
138- [Topics discussed]
139- [Instructions provided]
140
141### Orders/Referrals
142- [Labs/imaging ordered]
143- [Specialist referrals]
144```
145
146## Best Practices
147
1481. **Write comprehensively in one pass** - Gather all information first, then write the complete note
1492. **Use clear section headers** - Make each SOAP component easily identifiable
1503. **Include specific details** - Avoid vague statements; use measurable data
1514. **Maintain professional tone** - Use appropriate medical terminology
1525. **Ensure logical flow** - Assessment should follow from Objective findings; Plan should address Assessment
1536. **Document negative findings** - Note relevant systems reviewed that were normal
1547. **Include patient understanding** - Document that patient understood the plan
155
156## Example Usage
157
158When tasked with creating a SOAP note:
159
1601. Gather all available patient information from the task description
1612. Organize information into SOAP categories mentally or in notes
1623. Write the complete file with all four sections in one `write_file` operation
1634. Ensure no required section is missing before completing the task
164
165## File Format
166
167- Use markdown (.md) or plain text (.txt) for clarity
168- Include appropriate headers for each section
169- Use bullet points and numbered lists for readability
170- Keep file size comprehensive (typically 3000-10000+ bytes for complete notes)