writing-operative-reports

Creates structured operative notes with findings, technique, specimens, and estimated blood loss. Use when dictating operative reports, documenting surgical procedures, or recording intraoperative findings.

11 stars

Best use case

writing-operative-reports is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Creates structured operative notes with findings, technique, specimens, and estimated blood loss. Use when dictating operative reports, documenting surgical procedures, or recording intraoperative findings.

Teams using writing-operative-reports should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/writing-operative-reports/SKILL.md --create-dirs "https://raw.githubusercontent.com/CaseMark/skills/main/skills/med/writing-operative-reports/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/writing-operative-reports/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How writing-operative-reports Compares

Feature / Agentwriting-operative-reportsStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Creates structured operative notes with findings, technique, specimens, and estimated blood loss. Use when dictating operative reports, documenting surgical procedures, or recording intraoperative findings.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Writing Operative Reports

Creates structured operative notes with findings, technique, specimens, and estimated blood loss.

## Why This Skill Exists

The operative report is the single most important legal and clinical document produced during a surgical encounter. Joint Commission standard RC.02.01.01 requires that an operative report be completed immediately after surgery and made available in the medical record before the patient is transferred to the next level of care. Incomplete or delayed operative notes are a leading cause of malpractice exposure, coding denials, and continuity-of-care failures.

Operative reports drive downstream billing (CPT code selection), pathology correlation, postoperative management decisions, and medicolegal defense. A well-structured operative note reduces ambiguity for the care team, supports accurate ACS NSQIP data capture, and satisfies CMS Conditions of Participation. This skill ensures every operative report meets these professional and regulatory standards.

---

## Checkpoint A: Pre-Draft Intake (Mandatory)

1. What procedure(s) were performed? (Include CPT codes if available.) **Default: [VERIFY — obtain from surgical booking sheet]**
2. Who was the primary surgeon and any assistants? **Default: attending of record**
3. What was the ASA physical status classification of the patient? **Default: ASA II**
4. What type of anesthesia was administered (general, regional, MAC, local)? **Default: general endotracheal**
5. Were any specimens sent to pathology? If yes, how many containers and labeling? **Default: none**
6. What was the estimated blood loss (EBL)? **Default: minimal (<50 mL)**
7. Were any implants, grafts, or prosthetics used? **Default: none**
8. Were there any intraoperative complications or deviations from the planned procedure? **Default: none**

### Documents to Request

- Surgical booking sheet with planned procedure and laterality
- Anesthesia record (for ASA class, anesthesia type, intraoperative vitals)
- Preoperative imaging reports relevant to anatomy and approach
- Pathology requisition forms for any specimens
- Implant/device stickers or lot numbers
- Intraoperative photographs or video timestamps (if available)
- Prior operative reports (for revision or staged procedures)

---

## Step 1: Header and Patient Identification

Populate the operative report header using the following mandatory fields:

| Field | Source | Example |
|---|---|---|
| Patient name and MRN | Registration | Doe, Jane — MRN 123456 |
| Date of surgery | OR schedule | 2025-03-15 |
| Pre-op diagnosis | H&P / consult note | Acute appendicitis |
| Post-op diagnosis | Intraoperative findings | Gangrenous appendicitis with contained perforation |
| Procedure(s) performed | Booking + actual | Laparoscopic appendectomy, converted to open |
| Surgeon(s) | OR record | Dr. Smith (attending), Dr. Jones (PGY-3) |
| Anesthesia type | Anesthesia record | General endotracheal |
| ASA classification | Anesthesia record | ASA III |

The post-operative diagnosis must reflect actual intraoperative findings and may differ from the pre-operative diagnosis. Document any discrepancy explicitly.

---

## Step 2: Findings and Indications

Write a concise paragraph stating:

1. **Indication** — Why surgery was performed, including failed conservative management if applicable.
2. **Findings** — Objective intraoperative observations. Use anatomic terms (e.g., "the gallbladder wall was edematous and thickened to 6 mm with pericholecystic fluid"). Avoid subjective language like "looked bad."
3. **Pathology correlation** — Note whether findings were consistent with preoperative imaging and clinical presentation.

Include a description of any unexpected findings (e.g., incidental Meckel's diverticulum, adhesive disease, serosal implants) and what action was taken.

---

## Step 3: Technique Narrative

The technique section is the core of the operative report. Structure it chronologically:

1. **Positioning and preparation** — Patient position (supine, lateral decubitus, lithotomy), prep solution (chlorhexidine-alcohol, betadine), draping technique, and time-out confirmation.
2. **Access and exposure** — Incision type and location (e.g., "A 12-mm infraumbilical incision was made, and the abdomen was entered using the Hasson technique"), trocar placement with sizes, or open incision layers.
3. **Dissection and procedure** — Step-by-step narrative using active voice. Name each anatomic structure identified, the instrument or energy device used (e.g., "The cystic duct was identified, clipped x3 proximally and x1 distally with medium-large titanium clips, and divided with Metzenbaum scissors"), and critical decision points.
4. **Hemostasis** — Method of hemostasis (electrocautery, suture ligation, topical agents). Note the inspection of the operative field prior to closure.
5. **Closure** — Layers closed, suture types and sizes, skin closure method, dressing applied.
6. **Drain placement** — Type, size, location, fixation method, and whether placed to suction or gravity.

Use quantitative language throughout: "estimated blood loss 150 mL," not "moderate bleeding."

### Critical View of Safety and Decision Documentation

For certain procedures, document achievement of recognized safety landmarks:

| Procedure | Safety Landmark | Documentation Standard |
|---|---|---|
| Laparoscopic cholecystectomy | Critical View of Safety (CVS) | Two structures (cystic duct, cystic artery) entering the gallbladder with hepatocystic triangle cleared |
| Thyroidectomy | Recurrent laryngeal nerve identification | Visual identification or intraoperative nerve monitoring confirmation |
| Colectomy | Identification of ureter | Visual identification at key points of dissection |
| Hernia repair | Identification of cord structures | Ilioinguinal nerve, vas deferens, testicular vessels identified and preserved |

If intraoperative cholangiography, frozen section, or other adjunct was performed, document the indication, findings, and whether findings changed the operative plan.

---

## Step 4: Specimens, Implants, and Counts

- **Specimens**: List each specimen separately with container number, anatomic site, laterality, and orientation markers (e.g., "Specimen 1: right breast tissue, oriented with short suture superior, long suture lateral, sent fresh to pathology").
- **Implants**: Record manufacturer, device name, lot number, size, and anatomic placement site. Attach implant stickers to the operative report and permanent record.
- **Counts**: State whether sponge, needle, and instrument counts were correct at all stages. If a count discrepancy occurred, document the resolution (e.g., intraoperative X-ray obtained, item accounted for).

---

## Step 5: Disposition and Immediate Postoperative Plan

Document:

- Patient condition on transfer (e.g., "The patient was extubated in the operating room and transferred to the PACU in stable condition")
- Fluid totals: crystalloid input, urine output, EBL
- Immediate postoperative orders written (reference the postoperative order set)
- Any specific monitoring requirements (e.g., neurovascular checks Q1h, drain output Q4h)
- Whether the family was updated

---

## Checkpoint B: Post-Draft Alignment (Mandatory)

1. Does the post-op diagnosis match the intraoperative findings, not just the pre-op diagnosis?
2. Are all specimens accounted for with matching pathology requisitions?
3. Is the laterality correct throughout and consistent with the consent form?
4. Does the EBL match the anesthesia record within a reasonable range?
5. Are implant lot numbers and stickers present in the record?

---

## Quality Audit

- [ ] Report dictated/completed within the timeframe required by institutional policy (ideally immediately post-op)
- [ ] Pre-op diagnosis, post-op diagnosis, and procedure name are all present and distinct
- [ ] Surgeon name, assistant names, and roles documented
- [ ] ASA classification and anesthesia type recorded
- [ ] Findings section uses objective, anatomic language (no vague descriptors)
- [ ] Technique narrative is chronological, step-by-step, and uses active voice
- [ ] All specimens listed with labeling, orientation, and container count
- [ ] Implant details include manufacturer, lot number, and size
- [ ] Sponge/needle/instrument count status documented
- [ ] EBL stated as a numeric value
- [ ] Drain type, location, and output mechanism documented (if applicable)
- [ ] Patient disposition and condition on transfer documented
- [ ] No copy-paste artifacts from prior operative reports
- [ ] Laterality verified against consent and booking sheet

---

## Guidelines

1. Complete the operative report immediately after surgery — Joint Commission requires availability before the patient leaves the post-anesthesia recovery area.
2. Never change the post-operative diagnosis to match the pre-operative diagnosis when intraoperative findings differ; the post-op diagnosis must reflect surgical reality.
3. Use CPT-compliant terminology so coders can accurately assign procedure codes without inference.
4. Avoid eponyms unless universally understood (e.g., Pringle maneuver is acceptable; "the Jones technique" is not).
5. When a planned procedure is converted (e.g., laparoscopic to open), document the reason for conversion and the decision-making process.
6. For multi-surgeon cases, clearly delineate which surgeon performed which portion of the procedure.
7. Attach all implant stickers; missing stickers are a Joint Commission deficiency.
8. If trainee involvement exists, document the attending surgeon's presence and role per ACGME and CMS teaching-physician rules.

Related Skills

writing-surgical-consultation-notes

11
from CaseMark/skills

Creates structured surgical consultation responses with assessment and surgical candidacy determination. Use when responding to surgical consults, evaluating surgical candidates, or documenting surgical recommendations.

writing-irb-submissions

11
from CaseMark/skills

Creates IRB submission packages with protocol summaries, consent forms, and risk-benefit analysis. Use when submitting to IRB, preparing ethics applications, or writing consent documents.

writing-grant-applications-research

11
from CaseMark/skills

Structures NIH/foundation grant applications with specific aims, significance, and innovation sections. Use when writing research grants, preparing NIH applications, or structuring grant proposals.

writing-admission-orders

11
from CaseMark/skills

Generates structured admission order sets with diagnosis-specific protocols and safety checks. Use when admitting patients, creating admission orders, or setting up inpatient care plans.

managing-postoperative-pain

11
from CaseMark/skills

Structures multimodal pain management with ERAS protocols and opioid stewardship documentation. Use when managing post-surgical pain, implementing ERAS pathways, or tracking opioid use.

managing-postoperative-orders

11
from CaseMark/skills

Generates postoperative order sets with pain management, DVT prophylaxis, diet advancement, and activity progression. Use when writing post-op orders, managing surgical recovery, or creating post-procedure protocols.

managing-perioperative-nursing

11
from CaseMark/skills

Structures perioperative nursing documentation with pre/intra/post-operative assessments and counts. Use when documenting OR nursing care, performing surgical counts, or managing perioperative documentation.

managing-cardiac-risk-preoperative

11
from CaseMark/skills

Applies ACC/AHA perioperative cardiac evaluation algorithm with functional capacity and risk indices. Use when performing cardiac preop evaluation, calculating RCRI, or assessing perioperative cardiac risk.

conducting-preoperative-planning

11
from CaseMark/skills

Structures surgical planning with imaging review, risk stratification, and equipment/team requirements. Use when planning surgeries, reviewing preoperative imaging, or coordinating surgical teams.

conducting-pre-operative-evaluations

11
from CaseMark/skills

Structures pre-surgical risk assessment using ACC/AHA guidelines with cardiac and pulmonary clearance. Use when performing preop evaluations, assessing surgical risk, or providing medical clearance.

underwriting-agreement

11
from CaseMark/skills

Drafts a firm-commitment underwriting agreement for SEC-registered U.S. public offerings, covering purchase terms, greenshoe, reps and warranties, covenants, closing conditions, indemnification, and market-out rights. Use when drafting or reviewing underwriting agreements, firm commitment deals, over-allotment options, or listing approvals; trigger on "underwriting agreement", "firm commitment", "public offering", "greenshoe", "over-allotment", "registration statement", "prospectus".

writing-equity-research-notes

11
from CaseMark/skills

Creates structured equity research notes with thesis, valuation, risks, and rating justification. Use when initiating coverage, updating research opinions, or writing investment notes.