virtual-patient-roleplay
Simulate standardized patient encounters for medical training, supporting OSCE-style history-taking practice, communication skills rehearsal, and educational debriefing.
Install / Use
npx skills add aipoch/medical-research-skills --skill virtual-patient-roleplayInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Customer SupportSupported Platforms
Our assessment of virtual-patient-roleplay
virtual-patient-roleplay scores 88/100 on our quality scale, 188th of 319 Customer Support skills we index.
Its SKILL.md is 4.8 KB long, well organised into 13 sections with 2 code examples: a solid amount of guidance for an agent.
With 1,916 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so virtual-patient-roleplay is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
virtual-patient-roleplay compared with similar skills
All 4 of these similar skills score higher than virtual-patient-roleplay; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| virtual-patient-roleplay (this skill)by aipoch | 88 | 1.9k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install virtual-patient-roleplay?
- Run
npx skills add aipoch/medical-research-skills --skill virtual-patient-roleplay. The install tabs above show the steps for each supported agent. - Which AI agents does virtual-patient-roleplay work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is virtual-patient-roleplay safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is virtual-patient-roleplay still maintained?
- The repository was last updated about 2 months ago, so virtual-patient-roleplay is actively maintained.
Skill content
View source on GitHubname: 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
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
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
- Confirm the training goal, scenario type, learner level, and output focus (questioning, bedside manner, or debriefing).
- Check whether the request is for live roleplay, case setup, feedback, or post-encounter summary.
- Use the packaged simulator for supported scenarios; otherwise provide a manual roleplay scaffold without inventing unsupported medical certainty.
- Return the patient response or teaching artifact with assumptions, missed-question prompts, and debrief notes.
- If the request exceeds educational scope, stop and restate the boundary explicitly.
Usage
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
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| scenario | string | No | chest_pain | Scenario: chest_pain, headache, abdominal_pain |
| student_question | string | Yes (for interaction) | — | Learner question posed to the patient |
| difficulty | string | No | intermediate | Scenario 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:
- Training Objective
- Scenario Assumptions
- Roleplay Output
- Educational Limits
- Debrief and Next Checks
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.pyfails, 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
- references/references.md — Educational standards and simulation frameworks
- references/audit-reference.md — Supported scope, audit commands, and fallback boundaries
Response Template
Use the following fixed structure for non-trivial requests:
- Objective
- Inputs Received
- Assumptions
- Workflow
- Deliverable
- Risks and Limits
- Next Checks
If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
