opioid-mme-calculator
npx machina-cli add skill rhavekost/clinical-toolkit/opioid-mme-calculator --openclawOpioid MME Calculator
Description
This skill provides a structured way to calculate total daily MME using CDC conversion factors and safety cautions. It is a support tool and does not replace clinical judgment or patient-specific considerations.
Quick Reference
| Use | Purpose |
|---|---|
| MME calculation | Standardize opioid dose comparisons and monitor risk |
Interactive Mode (Lightweight)
Use this mode when the clinician asks to calculate MME step-by-step.
- Confirm readiness and the target time period (current daily regimen).
- Collect one medication at a time: name, route, dose, and frequency.
- Clarify PRN vs scheduled dosing and any long-acting vs short-acting formulations.
- Calculate per-opioid MME and then total daily MME.
- Summarize results and reference safety cautions.
Calculation Guide
See: assets/mme-calculation.md
Safety & Limitations
Documentation
- List each opioid, route, dose, and frequency
- Calculate each opioid’s daily MME
- Sum totals and note risk thresholds
Source
git clone https://github.com/rhavekost/clinical-toolkit/blob/main/dist/consumer/claude/opioid-mme-calculator/SKILL.mdView on GitHub Overview
Opioid MME Calculator provides a structured method to compute total daily morphine milligram equivalents using CDC conversion factors and safety cautions. It standardizes dosing for risk assessment, documentation, and taper planning, while clarifying that it is a support tool and does not replace clinical judgment.
How This Skill Works
The tool collects medications one at a time (name, route, dose, and frequency), calculates each opioid's daily MME using CDC conversion factors, and then sums to a total daily MME. It offers an Interactive Lightweight mode and links to a calculation guide and safety cautions, serving as a clinical aid rather than a replacement for professional judgment.
When to Use It
- Assess opioid dose risk during prescribing, reconciliation, or re-evaluation
- Standardize dose comparisons across multiple opioids and formulations
- Support taper planning and dose reduction strategies
- Document daily MME totals for patient records and audits
- Review safety cautions and threshold guidance with the patient
Quick Start
- Step 1: Confirm readiness and target time period (current daily regimen)
- Step 2: Collect one medication at a time: name, route, dose, and frequency
- Step 3: Calculate each opioid’s daily MME, sum totals, and reference safety cautions
Best Practices
- Confirm the target time period (current daily regimen) before calculations
- Collect one medication at a time with name, route, dose, and frequency
- Clarify PRN vs scheduled dosing and long-acting vs short-acting formulations
- Calculate per-opioid MME first, then sum to the total daily MME
- Document each opioid, route, dose, frequency, total MME, and note risk thresholds
Example Use Cases
- A clinician reconciles a patient on two opioids with different routes to determine a safe total daily MME
- A taper plan is developed by calculating current MME and outlining stepwise reductions
- Formulation changes are compared to maintain equivalent MME during a switch
- Daily MME totals are recorded in the chart to support risk assessment and monitoring
- Using the Interactive Mode to calculate MME step by step with safety caveats referenced