procedure-note-template — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited procedure-note-template (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Generate pre-populated procedure documentation templates from FHIR data. Pull patient demographics, procedure indication from active conditions, relevant pre-procedure labs (coagulation studies, platelets, hemoglobin), allergy list, and current anticoagulant status. Include required elements: informed consent verification, time-out documentation, procedure details, specimen handling, complications, and post-procedure orders. Support common bedside procedures: central venous catheter, arterial line, intubation, lumbar puncture, paracentesis, thoracentesis, chest tube, foley catheter, and NG tube.
| Resource | Purpose | Key Fields |
|---|---|---|
| Patient | Demographics for note header | name, birthDate, gender, identifier |
| Condition | Procedure indication | code, clinicalStatus |
| Observation | Pre-procedure labs (coags, CBC), vitals | code, value[x], effectiveDateTime |
| AllergyIntolerance | Allergy check (esp. latex, iodine, lidocaine) | code, reaction, clinicalStatus |
| MedicationRequest | Anticoagulant status, sedation orders | medicationCodeableConcept, status, dosageInstruction |
| MedicationAdministration | Sedation medications given | medicationCodeableConcept, dosage, effectiveDateTime |
| Consent | Informed consent status | status, scope, dateTime |
| Procedure | Create procedure record | code, status, performedDateTime, outcome, complication |
Tool: fhir_read
resourceType: "Patient"
id: "[patient-id]"Extract: name, DOB, age, gender, MRN for procedure note header and patient identification band verification.
Tool: fhir_search
resourceType: "Condition"
queryParams: "patient=[patient-id]&clinical-status=active"Match the stated procedure to an active condition as the indication. Common mappings:
Tool: fhir_search
resourceType: "Observation"
queryParams: "patient=[patient-id]&category=laboratory&code=http://loinc.org|5902-2,http://loinc.org|6301-6,http://loinc.org|777-3,http://loinc.org|718-7,http://loinc.org|3173-2&_sort=-date&_count=20"Critical pre-procedure LOINC codes:
Flag if:
Tool: fhir_search
resourceType: "AllergyIntolerance"
queryParams: "patient=[patient-id]&clinical-status=active"Flag procedure-relevant allergies:
Tool: fhir_search
resourceType: "MedicationRequest"
queryParams: "patient=[patient-id]&status=active&category=http://terminology.hl7.org/CodeSystem/medicationrequest-category|inpatient"Check active medications for anticoagulants and antiplatelets:
Tool: fhir_search
resourceType: "Consent"
queryParams: "patient=[patient-id]&status=active&scope=treatment"If no procedure-specific consent found, flag: "INFORMED CONSENT: NOT DOCUMENTED -- obtain before proceeding."
Tool: fhir_search
resourceType: "Observation"
queryParams: "patient=[patient-id]&category=vital-signs&_sort=-date&_count=10"Document baseline vitals before procedure.
PROCEDURE NOTE
===============
Patient: [name] | MRN: [mrn] | DOB: [dob] (Age: [age]) | Sex: [gender]
Date/Time: [procedure datetime]
Procedure: [procedure name]
Operator: [Flag: "Enter operator name and credentials"]
Supervising Physician: [if applicable]
Service: [service]
INDICATION
----------
[Condition from Step 2 with ICD-10 code]
INFORMED CONSENT
----------------
[Consent status from Step 6]
Risks, benefits, and alternatives discussed with: [patient / surrogate]
Consent signed: [date/time or "REQUIRED"]
ALLERGIES
---------
[List with procedure-relevant flags]
PRE-PROCEDURE VERIFICATION (TIME-OUT)
--------------------------------------
- [ ] Correct patient (two-identifier verification)
- [ ] Correct procedure confirmed
- [ ] Correct site/laterality marked (if applicable)
- [ ] Informed consent obtained
- [ ] Relevant labs reviewed:
PT/INR: [value] ([date]) [FLAG if abnormal]
Platelets: [value] ([date]) [FLAG if abnormal]
Hemoglobin: [value] ([date]) [FLAG if abnormal]
aPTT: [value] ([date]) [FLAG if abnormal]
- [ ] Anticoagulant status: [status from Step 5]
- [ ] Allergies reviewed: [summary]
- [ ] Equipment and supplies verified
PRE-PROCEDURE VITALS
---------------------
HR: [hr] | BP: [sys]/[dia] | RR: [rr] | SpO2: [spo2]% on [O2]
SEDATION / ANESTHESIA
----------------------
[Flag: "Complete if conscious sedation used"]
Sedation type: [none / local only / moderate sedation / deep sedation]
Medications administered:
- [Drug] [dose] [route] [time] [Flag: "Enter"]
- [Drug] [dose] [route] [time] [Flag: "Enter"]
Pre-sedation assessment: ASA class [I-V], Mallampati [I-IV], NPO status [hours]
Monitoring: Continuous pulse oximetry, cardiac monitor, ETCO2 (if applicable)
PROCEDURE DETAILS
-----------------
[Flag: "Operator to complete procedure details"]
Position: [supine / lateral decubitus / sitting / Trendelenburg]
Skin prep: [chlorhexidine / betadine] [Note allergy-based selection]
Draping: Sterile draping applied
Anesthesia: [lidocaine X% / bupivacaine X%] [volume] mL infiltrated to [site]
Technique: [Description of procedure steps]
Site: [anatomical location, laterality]
[Procedure-specific fields -- see references/procedure-documentation.md]
SPECIMENS
---------
[If applicable]
Type: [fluid / tissue / culture]
Sent to: [lab / microbiology / cytology / pathology]
Tests ordered: [cell count, culture, protein, glucose, LDH, cytology, etc.]
Labeled: [Yes -- two-identifier verification]
ESTIMATED BLOOD LOSS
--------------------
[volume] mL
COMPLICATIONS
-------------
[None / describe]
[Procedure-specific complication checklist -- see references/procedure-safety.md]
POST-PROCEDURE
--------------
Patient tolerated procedure: [well / with complications]
Post-procedure vitals: HR [hr] | BP [sys]/[dia] | SpO2 [spo2]%
Post-procedure imaging ordered: [CXR for central line/chest tube / none]
Post-procedure orders:
- [Site check q[interval]]
- [Dressing change instructions]
- [Activity restrictions]
- [Lab follow-up]
DISPOSITION
-----------
Patient returned to: [floor / ICU / recovery]
Attending notified: [Yes/No]Tool: fhir_create
resourceType: "Procedure"
resource: {
"resourceType": "Procedure",
"status": "completed",
"code": {
"coding": [{
"system": "http://www.ama-assn.org/go/cpt",
"code": "[CPT-code]",
"display": "[procedure-name]"
}]
},
"subject": {"reference": "Patient/[patient-id]"},
"encounter": {"reference": "Encounter/[encounter-id]"},
"performedDateTime": "[procedure-datetime]",
"performer": [{
"actor": {"reference": "Practitioner/[practitioner-id]"}
}],
"reasonReference": [{"reference": "Condition/[indication-condition-id]"}],
"outcome": {
"coding": [{
"system": "http://snomed.info/sct",
"code": "385669000",
"display": "Successful"
}]
},
"note": [{"text": "[brief procedure summary]"}]
}Common CPT codes:
User says: "Procedure note for central line placement on patient 11111."
Actions:
fhir_read Patient/11111. Returns: James Torres, DOB 1955-06-30, Male, MRN-11111.fhir_search Condition active. Returns: Septic shock (R65.21), pneumonia (J18.9), T2DM, CKD4.fhir_search Observation labs (coags, CBC). Returns: INR 1.2, platelets 188k, Hgb 9.8, aPTT 28.fhir_search AllergyIntolerance. Returns: Latex allergy (urticaria). Flag: USE NON-LATEX EQUIPMENT.fhir_search MedicationRequest anticoagulants. Returns: Heparin drip active -- held 2 hours ago, aPTT at hold was 55.fhir_search Observation vitals. Returns: HR 105, BP 88/52 on norepinephrine, SpO2 96% on 4L NC.Result:
PROCEDURE NOTE
===============
Patient: James Torres | MRN: MRN-11111 | DOB: 1955-06-30 (Age: 68) | Sex: Male
Procedure: Central venous catheter insertion (non-tunneled)
INDICATION: Septic shock requiring vasopressor administration (R65.21)
ALLERGIES
** LATEX ALLERGY (urticaria) -- USE NON-LATEX GLOVES AND EQUIPMENT **
PRE-PROCEDURE VERIFICATION
- Labs: INR 1.2 [OK] | Platelets 188k [OK] | Hgb 9.8 [OK] | aPTT 28 [OK]
- Anticoagulant: Heparin drip HELD 2h ago, aPTT at hold: 55
- Consent: [VERIFY]
PRE-PROCEDURE VITALS
HR: 105 | BP: 88/52 (on norepinephrine) | SpO2: 96% on 4L NC
[Procedure details: operator to complete -- site, technique, number of attempts,
catheter type/size, line placement confirmation method, post-procedure CXR ordered]User says: "Generate LP procedure note template for patient pt-222, meningitis workup."
Actions:
fhir_read Patient/pt-222. Returns: Emily Park, DOB 1990-03-22, Female.fhir_search Condition. Returns: Fever of unknown origin (R50.9), headache (R51.9), nuchal rigidity (R29.1).fhir_search Observation labs. Returns: INR 1.0, platelets 245k, Hgb 12.8, WBC 18.5.fhir_search AllergyIntolerance. Returns: NKDA.fhir_search MedicationRequest. Returns: No anticoagulants active.fhir_search Observation vitals. Returns: T 39.2C, HR 110, BP 128/78, SpO2 99% RA.Result: Pre-populated LP template with indication (meningitis workup), normal coags confirmed, no allergy concerns, specimen handling section pre-filled (tube 1: cell count/diff, tube 2: glucose/protein, tube 3: Gram stain/culture, tube 4: hold for additional studies), opening pressure documentation field, post-LP instructions (flat 1-2 hours, monitor for headache).
fhir_search DocumentReference with patient=[id]&type=http://loinc.org|59284-0 (LOINC 59284-0 = Consent document).system: "http://snomed.info/sct".code.text with the procedure name as free text.soap-note-generator - For documenting the encounter containing the procedureprogress-note-writer - For post-procedure daily documentationlab-result-interpreter - For interpreting pre-procedure lab valuespreoperative-lab-checklist - For verifying all required pre-procedure labs are current~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.