Clinical simulation scenario design for healthcare education
Create structured, realistic and educationally purposeful clinical simulation scenarios using ChatGPT.
Website · Report an issue · Request a feature
SimuGen is an open-source ChatGPT plugin for designing clinical simulation scenarios for healthcare education and training.
It helps educators turn a clinical idea, learning objective or broad topic into a structured simulation package that can include patient presentation, observations, investigations, scenario progression, expected learner actions, faculty guidance, equipment, moulage and debriefing prompts.
SimuGen is primarily designed around UK healthcare education, terminology and clinical context, while supporting other settings when requested.
- Structured clinical simulation scenario generation
- Adaptation to profession, learner level and clinical setting
- Clinically plausible patient presentations and observations
- Scenario progression based on learner actions
- Learning objectives and expected learner actions
- Faculty and simulated-patient guidance
- Equipment, environment and moulage requirements
- Debriefing questions and discussion themes
- UK-focused healthcare terminology and evidence sources
- Synthetic patient data designed specifically for simulation
- Support for paramedic, nursing, medical, mental health, paediatric, maternity and other healthcare scenarios
SimuGen can work from anything from a broad idea to a detailed educational brief.
Create a 20-minute paramedic simulation for final-year students
managing severe asthma in a home setting.
Build a ward-based nursing deterioration scenario using NEWS2,
with staged observations, expected learner actions and debrief questions.
Create a paediatric emergency simulation with learning objectives,
faculty guidance, equipment and scenario progression.
I have these learning outcomes for a simulation session.
Build a scenario around them for second-year students.
Depending on the request, SimuGen can produce:
- Scenario overview and learning objectives
- Patient profile and clinical background
- Initial presentation
- Vital signs and observations
- Relevant investigations
- Scenario phases and progression
- Expected learner actions
- Treatment and medication considerations
- Faculty and simulated-patient guidance
- Equipment and environmental requirements
- Moulage requirements
- Debriefing prompts
- Suggested educational resources
Outputs are adapted to the requested learner group, profession, setting and level of complexity.
SimuGen is designed for healthcare education and simulation, not for directing the diagnosis or treatment of a real patient.
Generated scenarios should use fictional training information only.
SimuGen is instructed not to request or generate genuine:
- NHS numbers
- Patient record numbers
- Home addresses
- Telephone numbers
- Government identifiers
- Other identifiable real-patient information
Users should not provide identifiable patient information or protected health information when creating scenarios.
Clinical content generated by AI can be incomplete or inaccurate. Educators remain responsible for reviewing scenarios before using them in teaching or assessment and should verify clinical information against current authoritative guidance and local organisational policies.
Where relevant, SimuGen is designed to work with UK healthcare terminology and recognised authoritative sources such as:
- NICE
- NHS
- Resuscitation Council UK
- British National Formulary
- Relevant Royal Colleges and professional bodies
- Current national and local clinical guidance
SimuGen should not fabricate citations, guideline recommendations or claims of alignment with guidance that has not been verified.
SimuGen is implemented as a skills-only OpenAI plugin.
plugin/
├── plugin.json
├── assets/
│ └── logo.png
└── skills/
└── generate-clinical-scenario/
├── SKILL.md
├── agents/
│ └── openai.yaml
└── references/
├── clinical-evidence.md
└── scenario-structure.md
Defines the portable plugin metadata, branding, public URLs and ChatGPT interface information.
Defines when the clinical scenario generation skill should activate and contains its core workflow, safety boundaries and completion criteria.
Provides skill-specific presentation metadata for OpenAI products.
Contains the detailed structure used when generating complete clinical simulation packages, including patient information, observations, progression, faculty guidance, equipment and debriefing.
Defines how clinical evidence, guidelines, medicines and current healthcare information should be handled and verified.
SimuGen currently requires no:
- Backend service
- Database
- User account
- Authentication
- MCP server
- External plugin API
The plugin operates entirely through its packaged skills and the capabilities provided by the host OpenAI product.
The public SimuGen website is hosted using GitHub Pages:
https://smcnab1.github.io/SimuGen/
It provides project information together with the current privacy policy and terms of service.
The website is a statically exported Next.js application and does not operate its own backend or database.
- Node.js 24 LTS
- npm
npm cinpm run devnpm run lintnpm run buildThe production build uses Next.js static export and outputs the website to out/ for deployment through GitHub Pages.
SimuGen/
├── .github/
│ ├── ISSUE_TEMPLATE/
│ └── workflows/
│ └── pages.yml
├── app/ # Public website
├── components/ # Website components
├── plugin/ # OpenAI plugin package
│ ├── assets/
│ ├── skills/
│ └── plugin.json
├── public/ # Website assets
├── submission/ # Public-submission test material
│ ├── release-notes.md
│ └── test-cases.md
├── CHANGELOG.md
├── LICENSE.md
├── PRIVACY.md
├── README.md
└── TERMS.md
Submission tests are maintained in:
submission/test-cases.md
The v1.0.0 test set covers:
- Fully specified scenario generation
- Clarification of broad requests
- Paediatric scenario generation
- User-supplied learning outcomes
- Complete faculty-ready packages
- Identifiable real-patient information
- Real-patient clinical-management requests
- Requests to fabricate evidence or guideline references
Release-specific submission information is maintained in:
submission/release-notes.md
These files are repository documentation and are not part of the packaged plugin itself.
The public plugin package consists of the contents of:
plugin/
The website, repository documentation, submission notes and development configuration are not required inside the submitted plugin package.
Development beyond the initial public release will focus on useful, distinct simulation workflows rather than expanding the generator unnecessarily.
Potential additions include:
- Clinical simulation scenario review
- Structured quality and educational-design feedback
- Scenario improvement recommendations
- Additional reusable simulation resources and templates
Distinct workflows will be implemented as separate skills where appropriate.
See the GitHub issues for current work and feature requests.
Contributions, bug reports and suggestions are welcome.
For a code contribution:
- Fork the repository.
- Create a feature branch.
- Make and test your changes.
- Commit the changes.
- Push your branch.
- Open a pull request.
For bugs, feature requests, support questions or concerns about generated clinical content, use the appropriate GitHub issue form.
Please do not include confidential, identifiable patient or sensitive personal information in issues, discussions or pull requests.
See CONTRIBUTING.md for further guidance.
Potentially inaccurate, unsafe, outdated or educationally inappropriate clinical content can be reported using the dedicated Clinical content issue form.
Reports should use fictional or synthetic examples only and should not contain identifiable patient information.
Security vulnerabilities should not be reported through public GitHub issues.
Use GitHub Private Vulnerability Reporting instead.
See SECURITY.md for further information.
SimuGen does not operate its own conversation-processing backend or database.
See:
Use of SimuGen is subject to its terms of service.
See:
For support, bug reports and feature requests:
github.com/smcnab1/SimuGen/issues
SimuGen is released under the MIT Licence.
Copyright © 2026 Sam McNab.