clinical-note-structuring

Structure unstructured clinical notes into SOAP format with ICD-10-CM and CPT codes.

6|5|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/writer/skills --skill clinical-note-structuring-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clinical-note-structuring
Source: https://github.com/writer/skills/tree/main/skills/clinical-note-structuring
Command: npx skills add https://github.com/writer/skills --skill clinical-note-structuring-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill transforms unstructured clinical notes into a standardized, structured SOAP format, making them easier to analyze, bill, and use for quality reporting.

Core Features & Use Cases

  • SOAP Structuring: Organizes free-text notes into Subjective, Objective, Assessment, and Plan sections.
  • Entity Extraction & Coding: Identifies and maps diagnoses to ICD-10-CM and procedures to CPT codes.
  • Quality Assessment: Evaluates documentation completeness and identifies gaps.
  • Use Case: A physician dictates a patient encounter. This Skill processes the dictation, extracts key medical information, assigns appropriate codes, and flags any missing documentation needed for billing or quality metrics.

Quick Start

Structure the provided clinical note into SOAP format, extracting diagnoses and procedures.

Frequently Asked Questions about clinical-note-structuring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert unstructured clinical notes into SOAP format?

To convert unstructured clinical notes into SOAP format, this Skill uses NLP to extract entities and organize the text into Subjective, Objective, Assessment, and Plan sections, making them easier to analyze and bill.

Can I automatically extract ICD-10-CM and CPT codes from free-text medical documentation?

Yes, you can extract ICD-10-CM and CPT codes from medical documentation. The Skill identifies diagnoses and procedures within the notes and maps them directly to these standardized medical codes.

How do I identify missing information in EHR documentation for billing?

To identify missing information in EHR documentation, the Skill assesses documentation quality against E/M guidelines, flags gaps in the clinical notes, and highlights missing details needed for billing and quality reporting.

Does this clinical note structuring tool work with E/M documentation guidelines?

Yes, this clinical note structuring tool works with E/M documentation guidelines. It evaluates the structured SOAP output against these guidelines to ensure documentation completeness and support accurate billing workflows.

What is the best way to structure dictated physician encounters for quality reporting?

The best way to structure dictated physician encounters for quality reporting is processing the dictation through NLP extraction. This parses the encounter into SOAP format, assigns codes, and flags missing documentation needed for quality metrics.

Are there limitations when using NLP for clinical entity extraction and mapping?

Limitations when using NLP for clinical entity extraction include relying on the clarity of the source text. If the unstructured clinical notes lack sufficient detail, the SOAP structuring and code mapping accuracy may be impacted.

Related Skills