New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Virtual Patient Roleplay

by aipoch in aipoch/medical-research-skills

Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.

MITAuto-check passedResearch & Science

Install Virtual Patient Roleplay

skills CLI
$ npx skills add aipoch/medical-research-skills --skill virtual-patient-roleplay -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills virtual-patient-roleplay --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/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-skills/Other/virtual-patient-roleplay .claude/skills/virtual-patient-roleplay && 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
virtual-patient-roleplay
GitHub stars
1.9k
Token cost
~1.2k tokens
SKILL.md length
507 words
Files
7 (incl. scripts, references)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.

  • Works in 5 steps: Confirm the training goal, scenario… → Check whether the request is for live… → Use the packaged simulator for supported… → …
  • Research & Science work in your project
  • SKILL.md covers Quick Check, When to Use, Workflow and Usage, plus 8 more sections
  • Runs Python scripts from its folder; calls python

What it does

Virtual Patient Roleplay is an agent skill from aipoch/medical-research-skills. Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/audit-reference.md`, `references/guidelines.md` and `references/references.md`).

It sits in Research & Science. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Research & Science work in your project

Example prompts

  • “/virtual-patient-roleplay”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the training goal, scenario type, learner level, and output focus (questioning, bedside manner, or debriefing).
  2. Check whether the request is for live roleplay, case setup, feedback, or post-encounter summary.
  3. Use the packaged simulator for supported scenarios; otherwise provide a manual roleplay scaffold without inventing unsupported medical…
  4. Return the patient response or teaching artifact with assumptions, missed-question prompts, and debrief notes.
  5. If the request exceeds educational scope, stop and restate the boundary explicitly.

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Virtual Patient Roleplay loads about 1.2k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 49 tokens; SKILL.md has 507 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 507 words, ~1,234 tokens.

Download SKILL.mdSave it as .claude/skills/virtual-patient-roleplay/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
virtual-patient-roleplay
description
Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

Virtual Patient Roleplay

Structured standardized-patient simulation for medical training and clinical interview practice.

Educational Disclaimer: All output is for training simulation only. This skill does not provide real clinical diagnosis, treatment selection, or emergency instructions. Faculty supervision is required for formal assessment use.

Quick Check

bash
python -m py_compile scripts/main.py
python -c "from scripts.main import PatientSimulator; sim=PatientSimulator('chest_pain'); print(sim.ask('Where does the pain go?')['patient_response'])"

When to Use

  • Use this skill for OSCE-style history-taking practice, communication skills rehearsal, or debrief planning.
  • Use this skill when a learner needs to practice clinical interviewing with a simulated patient response.
  • Do not use this skill for real patient triage, clinical diagnosis, treatment selection, or emergency guidance.

Workflow

  1. Confirm the training goal, scenario type, learner level, and output focus (questioning, bedside manner, or debriefing).
  2. Check whether the request is for live roleplay, case setup, feedback, or post-encounter summary.
  3. Use the packaged simulator for supported scenarios; otherwise provide a manual roleplay scaffold without inventing unsupported medical certainty.
  4. Return the patient response or teaching artifact with assumptions, missed-question prompts, and debrief notes.
  5. If the request exceeds educational scope, stop and restate the boundary explicitly.

Usage

text
python -c "from scripts.main import PatientSimulator; sim=PatientSimulator('chest_pain'); print(sim.ask('Where does the pain go?')['patient_response'])"
python -c "from scripts.main import PatientSimulator; sim=PatientSimulator('headache'); print(sim.ask('Did the pain start suddenly?')['patient_response'])"

Parameters

ParameterTypeRequiredDefaultDescription
scenariostringNochest_painScenario: chest_pain, headache, abdominal_pain
student_questionstringYes (for interaction)—Learner question posed to the patient
difficultystringNointermediateScenario difficulty level

Output

  • Simulated patient response
  • Scenario-specific cues and debrief elements
  • Explicit reminder that output is educational, not clinical advice

Scope Boundaries

  • This skill supports training simulations, not real clinical triage.
  • This skill does not provide diagnosis, treatment selection, or emergency instructions.
  • This skill should not be used as a substitute for faculty supervision or patient care.

Stress-Case Rules

For complex multi-constraint requests, always include these explicit blocks:

  1. Training Objective
  2. Scenario Assumptions
  3. Roleplay Output
  4. Educational Limits
  5. Debrief and Next Checks
Show full SKILL.md (216 more words)Show less

Error Handling

  • If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
  • If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
  • If scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback.
  • Do not fabricate clinical certainty, real patient data, or verified diagnostic outcomes.

Input Validation

This skill accepts: a scenario identifier and a learner question for standardized patient simulation in a medical training context.

If the request does not involve educational patient simulation — for example, asking for real clinical diagnosis, treatment recommendations, emergency triage, or non-medical roleplay — do not proceed with the workflow. Instead respond:

"virtual-patient-roleplay is designed for medical training simulations only. Your request appears to be outside this scope. Please provide a scenario and learner question for educational practice, or use a more appropriate tool."

References

Response Template

Use the following fixed structure for non-trivial requests:

  1. Objective
  2. Inputs Received
  3. Assumptions
  4. Workflow
  5. Deliverable
  6. Risks and Limits
  7. Next Checks

If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.

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

Files

SKILL.md and 6 other files (scripts, references) in scientific-skills/Other/virtual-patient-roleplay of aipoch/medical-research-skills.

  • SKILL.md
  • references/audit-reference.md
  • references/guidelines.md
  • references/references.md
  • requirements.txt
  • scripts/main.py
  • virtual-patient-roleplay_audit_result_v2.json

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Virtual Patient Roleplay 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.

Virtual Patient Roleplay compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Virtual Patient Roleplay this skillaipoch/medical-research-skills1.9k—~1.2kAutomated safety check: PassMIT
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes

  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed

  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed

  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes

  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes

More from aipoch/medical-research-skills

All 578 skills in this repo

  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    1.9k GitHub stars~2.2k tokensUpdated 24 days ago
    Auto-check passed

  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    1.9k GitHub stars~1.4k tokensUpdated 24 days ago
    Auto-check passed

  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    1.9k GitHub stars~3.7k tokensUpdated 24 days ago
    Auto-check passed

  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    1.9k GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed

  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    1.9k GitHub stars~1.7k tokensUpdated 24 days ago
    Auto-check passed

  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    1.9k GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed

Categories

Questions about Virtual Patient Roleplay

What does Virtual Patient Roleplay do?

Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing. Virtual Patient Roleplay is an agent skill from aipoch/medical-research-skills. Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.

When should I use Virtual Patient Roleplay?

Virtual Patient Roleplay fits situations like: research & Science work in your project.

How do I install Virtual Patient Roleplay in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill virtual-patient-roleplay -a claude-code`. Or copy the skill folder (scientific-skills/Other/virtual-patient-roleplay in aipoch/medical-research-skills) into .claude/skills/virtual-patient-roleplay in your project. Claude Code loads it when a task matches its description.

How do I install Virtual Patient Roleplay in Codex?

Run `npx skills add aipoch/medical-research-skills --skill virtual-patient-roleplay -a codex`. Or copy the skill folder (scientific-skills/Other/virtual-patient-roleplay in aipoch/medical-research-skills) into .agents/skills/virtual-patient-roleplay in your project. Codex loads it when a task matches its description.

Can I use Virtual Patient Roleplay 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 aipoch/medical-research-skills --skill virtual-patient-roleplay -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/virtual-patient-roleplay, .gemini/skills/virtual-patient-roleplay, .github/skills/virtual-patient-roleplay and .opencode/skills/virtual-patient-roleplay in your project.

What does Virtual Patient Roleplay need to run?

Going by SKILL.md and its folder, Virtual Patient Roleplay needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Virtual Patient Roleplay 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 Virtual Patient Roleplay 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Virtual Patient Roleplay use?

Virtual Patient Roleplay is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Virtual Patient Roleplay use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 542 tokens, read only when the agent opens those files.

What are the alternatives to Virtual Patient Roleplay?

Skills that share tags, products or a category with Virtual Patient Roleplay: Hypothesis Generation (spacering-net/codeg, 3.9k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars) and Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Virtual Patient Roleplay?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,937 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

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