Structure a clinical encounter into a clean SOAP note. An agent skill from mohitagw15856/pm-claude-skills.

MITAuto-check passed

Install Soap Note

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill soap-note -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills soap-note --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/soap-note .claude/skills/soap-note && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
soap-note
GitHub stars
1.4k
Token cost
~1k tokens
SKILL.md length
476 words
Files
1
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Structure a clinical encounter into a clean SOAP note. An agent skill from mohitagw15856/pm-claude-skills.

  • Asked to write a SOAP note
  • SKILL.md covers Working from a brief, Required Inputs, Output Format and Quality Checks, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Document a patient encounter

What it does

Soap Note is an agent skill from mohitagw15856/pm-claude-skills. Structure a clinical encounter into a clean SOAP note. Use when asked to write a SOAP note, document a patient encounter, turn visit notes into clinical documentation, or structure subjective/objective/assessment/plan. Produces a well-organised SOAP note — Subjective, Objective, Assessment (with differential), and Plan — from the provided encounter details, in standard clinical-documentation style.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to write a SOAP note
  • Document a patient encounter
  • Turn visit notes into clinical documentation
  • Structure subjective/objective/assessment/plan

Example prompts

  • “/soap-note”

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Soap Note loads about 1k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 476 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 476 words, ~1,001 tokens.

Download SKILL.mdSave it as .claude/skills/soap-note/SKILL.md (or your agent's skills folder).
name
soap-note
description
Structure a clinical encounter into a clean SOAP note. Use when asked to write a SOAP note, document a patient encounter, turn visit notes into clinical documentation, or structure subjective/objective/assessment/plan. Produces a well-organised SOAP note — Subjective, Objective, Assessment (with differential), and Plan — from the provided encounter details, in standard clinical-documentation style.

SOAP Note Skill

Good clinical documentation is structured so the next clinician can reconstruct the reasoning in seconds: what the patient reported, what was found, what you think, and what you'll do. This skill turns encounter notes into a clean SOAP note that follows that structure and keeps assessment separate from plan.

Clinical-safety note: this is a documentation-formatting aid, not medical advice or a diagnosis. It organises information a qualified clinician provides; all content must be reviewed and verified by the treating clinician before entering the medical record. Do not invent clinical findings, vitals, or results.

Working from a brief

Given rough encounter notes, produce the full structured note anyway — organise what's given into the four sections and place each detail correctly. Where a standard field wasn't provided, leave it clearly marked (e.g. "Vitals: not documented") rather than inventing a value. Never fabricate findings, labs, or measurements.

Required Inputs

Ask for these only if they aren't already provided (else mark as not documented):

  • Subjective — the patient's reported symptoms, history of present illness, relevant history.
  • Objective — exam findings, vitals, labs/imaging results (as provided).
  • Clinical impression — the working assessment / differential, if the clinician has one.
  • Plan — orders, treatment, follow-up, patient education (as provided).

Output Format

SOAP Note

S — Subjective

  • Chief complaint, HPI (onset, location, duration, character, aggravating/relieving, timing, severity), pertinent history and ROS as provided.

O — Objective

  • Vitals; physical exam by system; lab/imaging results. Only what was documented — mark anything absent as "not documented".

A — Assessment

  • The working diagnosis/clinical impression, with a brief differential where relevant. Keep reasoning here, separate from the plan.

P — Plan

  • Per problem: diagnostics ordered, treatment/medications, referrals, patient education, and follow-up. Numbered by problem when there are several.

End with a note of any fields not documented and a reminder that the treating clinician must verify before filing.

Show full SKILL.md (176 more words)Show less

Quality Checks

  • Each detail is in the correct SOAP section (symptoms in S, findings in O, reasoning in A, actions in P)
  • Assessment is kept separate from plan — diagnosis vs. what you'll do
  • No clinical value (vital, lab, finding) is invented — undocumented fields are marked, not guessed
  • The plan is actionable and tied to the assessed problem(s)
  • Standard clinical structure and abbreviations are used appropriately
  • A clinician-review reminder is included

Anti-Patterns

  • Do not invent vitals, labs, exam findings, or results to fill a section — mark them "not documented"
  • Do not present this as diagnosis or medical advice — it formats clinician-provided information
  • Do not blur assessment and plan into one block — they serve different readers and purposes
  • Do not drop pertinent negatives the clinician noted — they're part of the reasoning
  • Do not reorganise so heavily that the clinician's original meaning changes

Based On

Clinical documentation practice — the SOAP (Subjective, Objective, Assessment, Plan) format for structured, reviewable encounter notes.

Example Trigger Phrases

  • "Write a SOAP note."
  • "Document a patient encounter."
  • "Turn visit notes into clinical documentation."
  • "Structure subjective/objective/assessment/plan."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/soap-note of mohitagw15856/pm-claude-skills.

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Soap Note next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Soap Note compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Soap Note this skillmohitagw15856/pm-claude-skills1.4k—~1kAutomated safety check: PassMIT
Medical Soap Note CreationHKUDS/OpenSpace7.8k—~1.5kAutomated safety check: PassMIT
Automated Soap Note Generatoraipoch/medical-research-skills2k—~4.3kAutomated safety check: PassMIT
Soap Note CreationHKUDS/OpenSpace7.8k—~985Automated safety check: PassMIT
Automated Soap Note GeneratorLeoYeAI/openclaw-master-skills2.2k—~6.2kAutomated safety check: NotesMIT
Summarizing Clinical Notesmaziyarpanahi/openmed5.5k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

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

    7.8k GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Automated Soap Note Generator

    aipoch/medical-research-skills

    Generate structured SOAP notes from clinical narratives, transcripts, or existing notes; use when the user needs de-identified clinical documentation organized into Subjective, Objective…

    2k GitHub stars~4.3k tokensUpdated 22 days ago
    Research & ScienceAuto-check passed
  • Soap Note Creation

    HKUDS/OpenSpace

    Create structured medical SOAP notes with all four components in a single comprehensive file write

    7.8k GitHub stars~985 tokensUpdated 1 mo ago
    Auto-check passed
  • Automated Soap Note Generator

    LeoYeAI/openclaw-master-skills

    Transform unstructured clinical input (dictation, transcripts, or rough notes) into standardized SOAP (Subjective, Objective, Assessment, Plan) medical documentation.

    2.2k GitHub stars~6.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Summarizing Clinical Notes

    maziyarpanahi/openmed

    Produces structured, citation-anchored summaries of clinical notes — one-liner, hospital course, and problem-oriented views — where every claim cites a source span so nothing is hallucinated.

    5.5k GitHub stars~1.7k tokensUpdated today
    Research & ScienceAuto-check passed
  • Create structured medical SOAP notes by writing comprehensive content to a file in one iteration

    7.8k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Soap Note

What does Soap Note do?

Structure a clinical encounter into a clean SOAP note. An agent skill from mohitagw15856/pm-claude-skills. Soap Note is an agent skill from mohitagw15856/pm-claude-skills. Structure a clinical encounter into a clean SOAP note.

When should I use Soap Note?

Soap Note fits situations like: asked to write a SOAP note; document a patient encounter; turn visit notes into clinical documentation; structure subjective/objective/assessment/plan.

How do I install Soap Note in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill soap-note -a claude-code`. Or copy the skill folder (skills/soap-note in mohitagw15856/pm-claude-skills) into .claude/skills/soap-note in your project. Claude Code loads it when a task matches its description.

How do I install Soap Note in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill soap-note -a codex`. Or copy the skill folder (skills/soap-note in mohitagw15856/pm-claude-skills) into .agents/skills/soap-note in your project. Codex loads it when a task matches its description.

Can I use Soap Note in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill soap-note -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/soap-note, .gemini/skills/soap-note, .github/skills/soap-note and .opencode/skills/soap-note in your project.

What does Soap Note need to run?

SKILL.md names no scripts, command-line tools or credentials: Soap Note is instructions for the agent only.

Does Soap Note access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Soap Note safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Soap Note use?

Soap Note is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Soap Note use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Soap Note?

Skills that share tags, products or a category with Soap Note: Medical Soap Note Creation (HKUDS/OpenSpace, 7.8k stars), Automated Soap Note Generator (aipoch/medical-research-skills, 2k stars), Soap Note Creation (HKUDS/OpenSpace, 7.8k stars) and Automated Soap Note Generator (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Soap Note?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,433 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 8, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.