AGENT SKILL

medical-soap-note-creation

Transform unstructured clinical encounters into comprehensive SOAP notes with ICD codes and care plans

License 许可
MIT
所属仓库
HKUDS/AgentPilot
最近更新
2026-11-12
Stars
★ 8.0k
Forks
944

01 前言 Front Matter

name
medical-soap-note-creation
description
Transform unstructured clinical encounters into comprehensive SOAP notes with ICD codes and care plans

02 资源文件 1

03 SKILL.md 正文

Medical SOAP Note Creation

This skill provides a systematic approach to converting unstructured clinical encounter summaries into professional, comprehensive SOAP notes ready for electronic health record documentation.

Overview

SOAP notes organize clinical information into four standard sections:

  • Subjective: Patient's reported symptoms and history
  • Objective: Measurable clinical findings and data
  • Assessment: Clinical diagnosis and reasoning
  • Plan: Treatment strategy and follow-up

Step-by-Step Instructions

Step 1: Extract Key Information

Review the clinical encounter summary and identify:

  • Patient demographics (age, sex, relevant history)
  • Chief complaint and history of present illness
  • Review of systems findings
  • Physical examination results
  • Diagnostic test results (labs, imaging)
  • Current medications and allergies
  • Past medical/surgical history

Step 2: Structure the SOAP Note

Organize information into the four SOAP sections:

Subjective (S):

  • Chief complaint in patient's own words
  • History of present illness (onset, duration, severity, aggravating/relieving factors)
  • Review of systems (pertinent positives and negatives)
  • Relevant past medical, family, and social history

Objective (O):

  • Vital signs
  • Physical examination findings by system
  • Laboratory and imaging results
  • Current medication list

Assessment (A):

  • Primary diagnosis with ICD-10 code(s)
  • Differential diagnoses if applicable
  • Clinical reasoning connecting findings to diagnosis

Plan (P):

  • Medications (new prescriptions, changes, discontinuations)
  • Treatments and procedures
  • Patient education provided
  • Follow-up arrangements
  • Return precautions

Step 3: Write the Complete Note

Compose the full SOAP note in a single write_file operation to ensure completeness and efficiency:

from write_file import write_file

soap_note = """SOAP NOTE
Date: [Encounter Date]
Patient: [Patient Name/ID]

SUBJECTIVE:
[Patient's reported symptoms and history in organized paragraphs]

OBJECTIVE:
[Clinical findings and data in organized sections]

ASSESSMENT:
[Diagnosis with clinical reasoning and ICD codes]

PLAN:
[Specific, actionable treatment steps and follow-up]
"""

write_file(path="soap_note.txt", content=soap_note)

Step 4: Quality Checklist

Before finalizing, verify:

  • [ ] All four SOAP components present and clearly labeled
  • [ ] ICD-10 codes included for all diagnoses
  • [ ] Plan contains specific, actionable items with timelines
  • [ ] Follow-up instructions are clear and specific
  • [ ] Return precautions included
  • [ ] Note is comprehensive (typically 3000-10000 characters for complex cases)

Best Practices

  1. Be Specific: Use quantifiable measurements and precise clinical terminology
  2. Include ICD Codes: Always pair diagnoses with appropriate ICD-10 codes
  3. Actionable Plans: Ensure each plan item has clear next steps, dosages, and timelines
  4. Single Operation: Write the complete note in one write_file operation for efficiency and consistency
  5. Professional Tone: Use clinical language appropriate for medical records
  6. Patient-Centered: Include patient education and shared decision-making when applicable

Example Structure

SOAP NOTE
Date: 2024-01-15
Patient: [Name], [Age], [Sex]

SUBJECTIVE:
CC: [Chief complaint]

HPI: [History of present illness using OLDCARTS or similar framework - 
      onset, location, duration, characteristics, aggravating/relieving factors, 
      timing, severity]

ROS: [Review of systems - pertinent positives and negatives by system]

PMH: [Past medical history]
PSH: [Past surgical history]
Medications: [Current medications with dosages]
Allergies: [Known allergies and reactions]
FH: [Family history]
SH: [Social history]

OBJECTIVE:
VS: T [temp], BP [blood pressure], HR [heart rate], RR [respiratory rate], 
    SpO2 [oxygen saturation], Wt [weight]

General: [Appearance, distress level]
HEENT: [Head, eyes, ears, nose, throat findings]
CV: [Cardiovascular examination]
Resp: [Respiratory examination]
Abd: [Abdominal examination]
MSK: [Musculoskeletal examination]
Neuro: [Neurological examination]
Skin: [Dermatological findings]

Labs: [Relevant laboratory results with values and reference ranges]
Imaging: [Imaging study results]

ASSESSMENT:
1. [Primary diagnosis] - ICD-10: [code]
   [Brief clinical reasoning supporting diagnosis]

2. [Secondary diagnosis if applicable] - ICD-10: [code]
   [Brief clinical reasoning]

PLAN:
1. Medications:
   - [Medication name] [dosage] [route] [frequency] for [duration]
   
2. Treatments:
   - [Specific treatment or procedure]
   
3. Patient Education:
   - [Education topics discussed]
   
4. Follow-up:
   - Return to clinic in [timeframe] for [purpose]
   - [Any scheduled tests or appointments]
   
5. Return Precautions:
   - Return immediately if [warning symptoms]

Common ICD-10 Code Categories

  • Respiratory: J00-J99 (e.g., J06.9 acute upper respiratory infection)
  • Digestive: K00-K95 (e.g., K21.0 GERD with esophagitis)
  • Musculoskeletal: M00-M99 (e.g., M54.5 low back pain)
  • Cardiovascular: I00-I99 (e.g., I10 essential hypertension)
  • Endocrine: E00-E89 (e.g., E11.9 type 2 diabetes mellitus)
  • Infectious: A00-B99 (e.g., J02.9 acute pharyngitis)

Notes on Efficiency

Writing the complete SOAP note in a single write_file operation offers several advantages:

  • Reduces iteration overhead
  • Ensures consistency across all sections
  • Prevents partial or incomplete documentation
  • Maintains coherent clinical reasoning throughout
  • Faster completion time for clinical documentation tasks

04 同仓库更多 Skills

HKUDS
HKUDS/AgentPilot

agentpilot

Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.

★ 8.0k
HKUDS
HKUDS/AgentPilot

remember

Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.

★ 8.0k
HKUDS
HKUDS/AgentPilot

skill-discovery

Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

delegate-task

Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

write-special-chars-ts-check

Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.

★ 8.0k
HKUDS
HKUDS/AgentPilot

write-special-chars-readback

Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of /tmp helper scripts.

★ 8.0k