Clinical Case Report Skill
Generate a structured medical case presentation for clinical rounds,
conferences, or documentation. The output follows standard medical
formatting conventions used in hospital settings worldwide.
What you will produce
A single-page HTML case report (index.html). Content varies by format
(see references/case-formats.md — selected in Step 0):
SOAP / Conference format:
- Patient identification — age, sex, chief complaint
- History of Present Illness (HPI) — chronological narrative with
pertinent positives and negatives
- Past Medical History, Medications, Allergies
- Review of Systems
- Physical Examination — systematic findings by system
- Vital Signs — formatted table with reference ranges and flags
- Investigations — laboratory results and imaging findings
- Assessment — primary diagnosis and differential (3–5 items)
with clinical reasoning for each
- Management Plan — evidence-based, organised by problem
Brief Rounds format (daily review, ward round, handover, ICU, post-call):
- ID line — age, sex, day of admission, primary problem
- Interval events / current status — what has changed since last review
- Active problems — numbered list
- Plan-by-problem — concise actions for each active problem
- Full HPI and systematic physical examination are not included
Step-by-step workflow
Step 0 — Load reference files
Before starting, read both reference files:
references/case-formats.md — use this to choose the correct output
format (SOAP, Conference, or Brief Rounds) based on the user's context
references/checklist.md — keep P0 gates in mind throughout; you
must pass all P0 items before emitting the final artifact
Step 1 — Parse the brief
Read the user's prompt and extract:
- Patient age and sex
- Chief complaint or presenting problem
- Any vitals, labs, or imaging the user has provided
- Clinical context: ED, ward rounds, conference case, outpatient, etc.
- Specialty context: cardiology, emergency, internal medicine, etc.
If the chief complaint or presenting problem is missing:
- SOAP / Conference: ask one clarifying question before proceeding. Do not proceed without it.
- Brief Rounds: if the admission problem or ID line is already available (e.g. "day-3 ICU review for septic shock"), proceed directly — a separate chief complaint is not required.
Step 2 — Build the clinical narrative
For SOAP / Conference outputs: write the HPI as a continuous prose
narrative in standard clinical style:
"This is a [age]-year-old [sex] with a history of [relevant PMH] who
presents with [chief complaint]. Symptoms began [timeline] and are
characterised by [quality, severity, radiation]. Associated symptoms
include [list]. Pertinent negatives include [list]."
The HPI must be chronological. Include timeline markers
("2 hours prior to presentation", "onset yesterday morning").
For Brief Rounds outputs (daily review, ward round, handover, ICU,
post-call): skip the full HPI and examination. Instead produce:
- ID line: "[Age][sex], Day [N] of admission, [primary problem]"
- Interval events / current status: what has changed since last review
- Active problems: numbered list
- Plan-by-problem: concise action for each active problem
Step 3 — Generate physiologically consistent clinical data
If the user has not provided specific values, generate values that are
internally consistent with the diagnosis:
Consistency checks (typical patterns):
- A patient in shock typically has: HR >100, SBP <90, raised lactate,
impaired capillary refill — but medications (beta-blockers), age, or
shock type (neurogenic, spinal) can alter this pattern
- Pneumonia typically presents with raised WBC, raised CRP,
temperature >38°C — but afebrile pneumonia exists, especially in
the elderly or immunocompromised
- A STEMI typically shows ST elevation in contiguous leads and raised
high-sensitivity troponin — but early presentations may have initially
normal troponin; CK-MB is not universally required
- Sepsis typically shows raised or low WBC, raised lactate >2,
temperature abnormality — but compensated early sepsis may present
with normal vitals
- Lab units must match convention: creatinine in µmol/L or mg/dL
(state which), glucose in mmol/L, haemoglobin in g/dL
Critical rule — preserve user-provided data:
- Never overwrite a value the user has explicitly stated
- If a user-provided value is atypical for the diagnosis, keep it and
note the atypical presentation in the assessment rather than
forcing canonical numbers
- Never generate a value that contradicts the stated diagnosis
Step 4 — Write the assessment
The assessment section must contain:
- Primary diagnosis stated clearly on the first line
- Clinical reasoning — one sentence explaining why this is the
most likely diagnosis
- Differential diagnosis — exactly 3 to 5 items, each with one
sentence of supporting or refuting evidence
- Risk stratification — include a validated clinical score where
applicable (TIMI for ACS, GRACE for ACS, Killip class + Shock Index
for STEMI/cardiogenic shock, CURB-65 for pneumonia, qSOFA for sepsis,
Wells for PE, etc.). Killip class and Shock Index together are
accepted as sufficient risk stratification for STEMI/cardiogenic shock cases.
Step 5 — Write the management plan
The plan must be:
- Specific: write drug names, doses, routes, and frequencies.
Do not write "start antibiotics" — write
"Piperacillin-Tazobactam 4.5g IV q8h for 5 days"
- Organised by problem using numbered headers
- Evidence-based: management must reflect current standard of care
for the diagnosis
- Complete: include investigations to order, monitoring parameters,
consults to request, and disposition
If you are uncertain about a specific dose, write
"[drug name] — dose per local formulary/protocol" rather than
inventing a dose.
Important — Prescribing Safety
Generated plans must:
- Be marked as educational/simulated, not a substitute for clinician judgment
- Use "per local formulary/protocol" language when required patient variables
(weight, renal function, allergies) are missing from the brief
- List key contraindications and unknowns before medication recommendations
when relevant patient data has not been provided
- Never claim a plan is "definitive" or "standard of care" without full
patient context (allergy status, renal/hepatic function, pregnancy
status, weight, anticoagulation/bleeding risk)
- Include a disclaimer footer in the HTML output stating the case is for
educational and documentation purposes only
Step 6 — Write index.html
Requirements for the HTML output:
- Professional medical document typography
(Georgia or system serif font preferred)
- White background, dark text — suitable for printing
- Vital signs and lab results in HTML
<table> elements
- Critical findings (ST elevation, raised troponin, low BP, etc.)
highlighted in a visually distinct callout box with red left border
- @media print CSS rules so the document prints cleanly on A4/Letter
- Tag every major section with
data-od-id for comment-mode targeting:
<section data-od-id="hpi">...</section>
<section data-od-id="vitals">...</section>
<section data-od-id="pmh">...</section>
<section data-od-id="examination">...</section>
<section data-od-id="investigations">...</section>
<section data-od-id="assessment">...</section>
<section data-od-id="plan">...</section>
Step 7 — Self-check against references/checklist.md
Before emitting <artifact>, run every P0 item in references/checklist.md.
All P0 items must pass. Fix any failures before emitting.
1---2name: clinical-case-report3description: Structured medical case presentation for clinical rounds, conferences, and documentation. Generates SOAP-format or narrative case reports with physiologically accurate vitals, labs, and evidence-based plans. Use when the brief mentions "case report", "case presentation", "SOAP note", "clinical case", "ward rounds", "case summary", or "patient presentation".4---5
6# Clinical Case Report Skill
7
8Generate a structured medical case presentation for clinical rounds,
9conferences, or documentation. The output follows standard medical
10formatting conventions used in hospital settings worldwide.
11
12## What you will produce
13
14A single-page HTML case report (`index.html`). Content varies by format
15(see `references/case-formats.md` — selected in Step 0):
16
17**SOAP / Conference format:**
18- **Patient identification** — age, sex, chief complaint
19- **History of Present Illness (HPI)** — chronological narrative with
20 pertinent positives and negatives
21- **Past Medical History, Medications, Allergies**
22- **Review of Systems**
23- **Physical Examination** — systematic findings by system
24- **Vital Signs** — formatted table with reference ranges and flags
25- **Investigations** — laboratory results and imaging findings
26- **Assessment** — primary diagnosis and differential (3–5 items)
27 with clinical reasoning for each
28- **Management Plan** — evidence-based, organised by problem
29
30**Brief Rounds format** (daily review, ward round, handover, ICU, post-call):
31- **ID line** — age, sex, day of admission, primary problem
32- **Interval events / current status** — what has changed since last review
33- **Active problems** — numbered list
34- **Plan-by-problem** — concise actions for each active problem
35- Full HPI and systematic physical examination are **not** included
36
37---
38
39## Step-by-step workflow
40
41### Step 0 — Load reference files
42
43Before starting, read both reference files:
44
451. `references/case-formats.md` — use this to choose the correct output
46 format (SOAP, Conference, or Brief Rounds) based on the user's context
472. `references/checklist.md` — keep P0 gates in mind throughout; you
48 must pass all P0 items before emitting the final artifact
49
50### Step 1 — Parse the brief
51
52Read the user's prompt and extract:
53
54- Patient age and sex
55- Chief complaint or presenting problem
56- Any vitals, labs, or imaging the user has provided
57- Clinical context: ED, ward rounds, conference case, outpatient, etc.
58- Specialty context: cardiology, emergency, internal medicine, etc.
59
60If the chief complaint or presenting problem is missing:
61- **SOAP / Conference**: ask one clarifying question before proceeding. Do not proceed without it.
62- **Brief Rounds**: if the admission problem or ID line is already available (e.g. "day-3 ICU review for septic shock"), proceed directly — a separate chief complaint is not required.
63
64### Step 2 — Build the clinical narrative
65
66**For SOAP / Conference outputs:** write the HPI as a continuous prose
67narrative in standard clinical style:
68
69> "This is a [age]-year-old [sex] with a history of [relevant PMH] who
70> presents with [chief complaint]. Symptoms began [timeline] and are
71> characterised by [quality, severity, radiation]. Associated symptoms
72> include [list]. Pertinent negatives include [list]."
73
74The HPI must be chronological. Include timeline markers
75("2 hours prior to presentation", "onset yesterday morning").
76
77**For Brief Rounds outputs** (daily review, ward round, handover, ICU,
78post-call): skip the full HPI and examination. Instead produce:
79
80- **ID line**: "[Age][sex], Day [N] of admission, [primary problem]"
81- **Interval events / current status**: what has changed since last review
82- **Active problems**: numbered list
83- **Plan-by-problem**: concise action for each active problem
84
85### Step 3 — Generate physiologically consistent clinical data
86
87If the user has not provided specific values, generate values that are
88internally consistent with the diagnosis:
89
90**Consistency checks (typical patterns):**
91
92- A patient in shock **typically** has: HR >100, SBP <90, raised lactate,
93 impaired capillary refill — but medications (beta-blockers), age, or
94 shock type (neurogenic, spinal) can alter this pattern
95- Pneumonia **typically** presents with raised WBC, raised CRP,
96 temperature >38°C — but afebrile pneumonia exists, especially in
97 the elderly or immunocompromised
98- A STEMI **typically** shows ST elevation in contiguous leads and raised
99 high-sensitivity troponin — but early presentations may have initially
100 normal troponin; CK-MB is not universally required
101- Sepsis **typically** shows raised or low WBC, raised lactate >2,
102 temperature abnormality — but compensated early sepsis may present
103 with normal vitals
104- Lab units must match convention: creatinine in µmol/L or mg/dL
105 (state which), glucose in mmol/L, haemoglobin in g/dL
106
107**Critical rule — preserve user-provided data:**
108- Never overwrite a value the user has explicitly stated
109- If a user-provided value is atypical for the diagnosis, keep it and
110 note the atypical presentation in the assessment rather than
111 forcing canonical numbers
112- Never generate a value that contradicts the stated diagnosis
113
114### Step 4 — Write the assessment
115
116The assessment section must contain:
117
1181. **Primary diagnosis** stated clearly on the first line
1192. **Clinical reasoning** — one sentence explaining why this is the
120 most likely diagnosis
1213. **Differential diagnosis** — exactly 3 to 5 items, each with one
122 sentence of supporting or refuting evidence
1234. **Risk stratification** — include a validated clinical score where
124 applicable (TIMI for ACS, GRACE for ACS, Killip class + Shock Index
125 for STEMI/cardiogenic shock, CURB-65 for pneumonia, qSOFA for sepsis,
126 Wells for PE, etc.). Killip class and Shock Index together are
127 accepted as sufficient risk stratification for STEMI/cardiogenic shock cases.
128
129### Step 5 — Write the management plan
130
131The plan must be:
132
133- **Specific**: write drug names, doses, routes, and frequencies.
134 Do not write "start antibiotics" — write
135 "Piperacillin-Tazobactam 4.5g IV q8h for 5 days"
136- **Organised by problem** using numbered headers
137- **Evidence-based**: management must reflect current standard of care
138 for the diagnosis
139- **Complete**: include investigations to order, monitoring parameters,
140 consults to request, and disposition
141
142If you are uncertain about a specific dose, write
143"[drug name] — dose per local formulary/protocol" rather than
144inventing a dose.
145
146### Important — Prescribing Safety
147
148Generated plans must:
149- Be marked as educational/simulated, not a substitute for clinician judgment
150- Use "per local formulary/protocol" language when required patient variables
151 (weight, renal function, allergies) are missing from the brief
152- List key contraindications and unknowns before medication recommendations
153 when relevant patient data has not been provided
154- Never claim a plan is "definitive" or "standard of care" without full
155 patient context (allergy status, renal/hepatic function, pregnancy
156 status, weight, anticoagulation/bleeding risk)
157- Include a disclaimer footer in the HTML output stating the case is for
158 educational and documentation purposes only
159
160### Step 6 — Write `index.html`
161
162Requirements for the HTML output:
163
164- Professional medical document typography
165 (Georgia or system serif font preferred)
166- White background, dark text — suitable for printing
167- Vital signs and lab results in HTML `<table>` elements
168- Critical findings (ST elevation, raised troponin, low BP, etc.)
169 highlighted in a visually distinct callout box with red left border
170- @media print CSS rules so the document prints cleanly on A4/Letter
171- Tag every major section with `data-od-id` for comment-mode targeting:
172
173```html
174<section data-od-id="hpi">...</section>
175<section data-od-id="vitals">...</section>
176<section data-od-id="pmh">...</section>
177<section data-od-id="examination">...</section>
178<section data-od-id="investigations">...</section>
179<section data-od-id="assessment">...</section>
180<section data-od-id="plan">...</section>
181```
182
183### Step 7 — Self-check against `references/checklist.md`
184
185Before emitting `<artifact>`, run every P0 item in `references/checklist.md`.
186All P0 items must pass. Fix any failures before emitting.