MD2SKILL

Convert your MD to Skill.MD

An open-source library of clinical decision support skills built from published medical guidelines. Each skill is a structured, step-by-step prompt that turns any AI assistant into a bedside clinical tool.

884 skills · 11 specialties · grounded in published guidelines · MIT licensed

---

What Is This?

Medical guidelines are long, dense, and hard to use mid-clinic. MD2SKILL extracts the actionable, decision-making parts and converts them into structured prompts (skills) that work with any AI tool.

Instead of reading a 40-page guideline to classify a diabetic foot infection, you describe the case and your AI walks you through the exact same framework — step by step, in real time.

Not a summary. A clinical decision tool.

---

The MD2SKILL Pipeline

flowchart TD
    A["🔍 Step 1 — Identify the Skill Gap\nWhat clinical decision is hard, slow,\nor inconsistent at the bedside?"]
    B["📚 Step 2 — Find the Evidence\nLocate the published guideline or research\narticle that addresses the skill gap"]
    C["⚙️ Step 3 — Process with MD2SKILL Identifier\nExtract actionable decision components\nfrom the guideline using md2skill-converter.md"]
    D["🛠️ Step 4 — Build the Skill\nCreate SKILL.md + system-prompt.md\nfor each identified component"]
    E["🧠 Step 5 — Refine with Expertise\nAdjust, validate, and enrich the skill\nusing your own clinical knowledge"]
    F["🚀 Step 6 — Deploy\nUse the skill in your AI platform of choice"]

    A --> B
    B --> C
    C --> D
    D --> E
    E --> F

    F --> G["Claude\n(SKILL.md)"]
    F --> H["ChatGPT\n(Custom GPT)"]
    F --> I["Gemini\n(Gem)"]
    F --> J["Perplexity\n(Spaces)"]

    style A fill:#1e3a5f,color:#fff,stroke:#1e3a5f
    style B fill:#1e3a5f,color:#fff,stroke:#1e3a5f
    style C fill:#1e3a5f,color:#fff,stroke:#1e3a5f
    style D fill:#1e3a5f,color:#fff,stroke:#1e3a5f
    style E fill:#1e3a5f,color:#fff,stroke:#1e3a5f
    style F fill:#2d6a4f,color:#fff,stroke:#2d6a4f
    style G fill:#40916c,color:#fff,stroke:#40916c
    style H fill:#40916c,color:#fff,stroke:#40916c
    style I fill:#40916c,color:#fff,stroke:#40916c
    style J fill:#40916c,color:#fff,stroke:#40916c

Loading

Full methodology: meta/md2skill-philosophy.md · Skill builder: meta/md2skill-converter.md

---

Supported Platforms

Each skill has two files:

File	For
SKILL.md	Claude · OpenClaw · Perplexity Computer — native skill install, auto-triggers
system-prompt.md	ChatGPT · Gemini · Perplexity Spaces — paste as Instructions

Use with ChatGPT Custom GPTs

Two modes — see meta/chatgpt-custom-gpt-setup.md for full instructions:

Mode	When to use	What to do
Single-skill GPT	One GPT, one clinical task	Paste system-prompt.md into Instructions field
Multi-skill GPT	One GPT, multiple related skills	Paste master routing prompt into Instructions + upload SKILL.md files to Knowledge

The meta/chatgpt-master-system-prompt.md file contains a copy-paste ready master prompt with routing logic, skill chaining, structured response format, and a worked example (Transplant Medicine — DBD Donor Eligibility + MAPI Score Calculator).

---

SKILL.md — Native install

Platform	How to install
Claude (Cowork / Claude Code)	Drop into .claude/skills/<skill-name>/
OpenClaw	Install via the platform's skill installer
Perplexity Computer	Install via the platform's skill installer

system-prompt.md — Paste as Instructions

Platform	Where to paste
ChatGPT Custom GPT	GPT Builder → Configure → Instructions
ChatGPT Projects	Project → Instructions
Gemini	gem.google.com → Create a Gem → Instructions
Perplexity Spaces	Space → Settings → Instructions

---

Skills Library

884 skills across 11 specialties. The tables below show coverage by sub-specialty — click any folder link to browse the skills inside.

🩺 Endocrinology — 833 skills

Sub-specialty	Skills	Scope
Pituitary & Acromegaly	98	Acromegaly diagnosis & management (SRL/pegvisomant/surgery/RT), central diabetes insipidus (DDAVP protocols), central hypothyroidism (LT4 dosing, TSH targets), pituitary apoplexy, prolactinoma, GH deficiency testing & replacement, hypopituitarism workup, LH/FSH/ACTH/TSH deficiency (ES 2025 guidelines)
Adrenal	115	ES-PA (ARR screening, AVS, MRA selection), JES-PA (confirmatory tests, pregnancy), ESA-PA (18-oxo/18-OHB interpretation, GRA management), ENDA primary adrenal insufficiency (glucocorticoid/mineralocorticoid dosing, sick-day rules, crisis management), ATA secondary AI (stress dosing, HPA axis recovery)
Phaeochromocytoma & PPGL	70	Full ATA-PPGL + JES-PPGL set — screening, biochemistry, imaging modality selection (123I-MIBG / 68Ga-DOTATATE / 18F-FDG-PET), genetic testing, GAPP/COPPS/PASS metastasis risk scoring, surgical approach, perioperative alpha-blockade, pregnancy, metastatic treatment, radionuclide therapy
Hypogonadism, FHA & Hirsutism	128	Functional hypothalamic amenorrhea (ES 2023 — energy rebalancing, BMD, fertility, HRT options), hirsutism/PCOS (ES 2018 — androgen testing, pharmacotherapy, cosmetic options), testosterone therapy in women (diagnosis, indications, monitoring, cessation); male hypogonadism & testosterone therapy (ICSM 2025 — diagnosis confirmation, assay selection, indications, contraindications, prostate/haematocrit monitoring, fertility preservation, shared decision-making)
Inpatient Diabetes & GCIH	70	Basal/correctional/premeal insulin protocols, GCIH classification & titration, perioperative BG targets, inpatient CGM, DPP-4i use, glucagon, carb counting, structured education (ES 2022 inpatient hyperglycemia)
Diabetes Technology	58	CGM initiation, continuation & discontinuation (inpatient & outpatient), rtCGM vs SMBG, CSII candidacy, training & assessment protocols, pump hospital policies, insulin bolus calculator, DKA prevention, hypoglycemia management (ES/ADA 2023)
Lipidology	52	Statin/non-statin selection, ASCVD risk, lipoprotein(a), TG management, lipid monitoring, familial dyslipidaemia, special populations
Cushing Syndrome	45	ES 2024 — diagnosis (UFC, LNSC, DST), TSS vs alternative surgery, pituitary-directed medical therapy, steroidogenesis inhibitors, bilateral adrenalectomy, postoperative cortisol management, recurrence surveillance, comorbidity treatment
Preventive Care	29	ADA vaccination, vitamin D screening (who NOT to test), supplementation thresholds by age/risk group, daily vs intermittent dosing
Pediatric Obesity	34	CMAJ 2025 set + ESO 2025 — BMI classification, comorbidity triggers, pharmacotherapy initiation & discontinuation, bariatric eligibility, lipid/glucose/BP interpretation by age, healthy eating & activity
Metabolic Bone (Paget's Disease)	23	Diagnostic workup, treatment indication, bisphosphonate selection & monitoring, complications; glucocorticoid & LT4 overreplacement fracture risk
Obesity	23	Pharmacotherapy eligibility, dose escalation, 5% efficacy threshold, off-label prescribing, antihypertensive & antihistamine & AED/antidepressant/antipsychotic weight-conscious selection, shared decision-making tools
Calcium Disorders	25	Hypercalcemia severity, diagnostic algorithm, malignancy workup, medication-induced screen; ES HCM protocol (IV fluids, bisphosphonate/denosumab/calcimimetic selection, renal dose adjustment, parathyroid carcinoma)
Gender Medicine	26	ES 2017 gender-affirming hormone therapy — eligibility criteria, pubertal suppression, sex-hormone induction, surgery readiness, CVD & bone & cancer surveillance, fertility counselling
GLP-1 Receptor Agonists	17	Candidacy, dose escalation, GI AE management, perioperative aspiration, ocular safety (NAION, DR), prescribing guides (Mounjaro, Wegovy, Noveltreat)
Diabetes in Pregnancy	10	Pre-existing diabetes management in pregnancy (PDM)
Thyroid Cancer	4	ATA DTC initial risk stratification, dynamic risk reclassification, Bethesda cytology management, RAI decision
Thyroid Nodule	3	EU-TIRADS classifier, ATA FNA decision, palpable nodule ultrasound
T2DM	1 + 2 root	HbA1c targets & intensification, comorbidity-driven medicine selector, newly-diagnosed OAD selector

🧒 Pediatric Endocrinology — 27 skills

Sub-specialty	Skills	Scope
Pediatric Obesity	6	Cross-listed with endocrinology — CMAJ 2025 full set
Congenital Adrenal Hyperplasia (CAH)	4	Newborn screening 17-OHP interpretation, newborn subtype differentiator, infant hydrocortisone dosing, adrenal crisis protocol
Growth & GH Therapy	8	ES 2022 GH treatment in children with cancer history — contraindications (TKI, spinal RT), oncologist consultation, treatment offer & regimen, short stature screening, sitting height
Growth Hormone (extended)	6	Extended GH therapy skills — additional indications, monitoring protocols, and dose adjustment guidance
Puberty Disorders	3	Central precocious puberty — screening indication, treatment approach, hormone testing

👶 Pediatric Medicine — 6 skills

Folder	Skills	Scope
Pediatric Obesity	6	Cross-listed CMAJ 2025 set for non-endocrine pediatric workflow

🧠 Neurology — 4 skills

Sub-specialty	Skills	Scope
Vestibular / Dizziness	4	Dizziness type classifier, red-flag screener, peripheral vs central vertigo, BPPV differential

🫃 Gastroenterology — 4 skills

Sub-specialty	Skills	Scope
Constipation	3	Laxative selector, defecatory disorder workup, Movicol prescribing
Pre-Procedure (GLP-1)	1	AGA 2024 — proceed / postpone / modify for patients on GLP-1 RAs

🩸 Haematology & Oncology — 3 skills

Sub-specialty	Skills	Scope
Multiple Myeloma	3	Diagnostic workup, ASCT eligibility, MRD assessment

🫀 Transplant Medicine — 2 skills

Folder	Skills	Scope
Kidney Transplant	2	DBD donor eligibility (DM/HTN), MAPI score calculator

🧫 Infectious Disease — 2 skills

Sub-specialty	Skills	Scope
Diabetic Foot	2	IWGDF/IDSA 2023 — severity classifier, empiric antibiotic selector

🫀 Cardiology — 1 skill

Sub-specialty	Skills	Scope
Lipidology	1	Bemdec (bempedoic acid) prescribing guide

🧬 Genetics & Genomics — 1 skill

Folder	Skills	Scope
NHS Genomic Test Directory	1	Lookup of R-codes, gene panels & commissioning categories across 457 rare-disease indications (NHS England v9.0, April 2026)

🚽 Urology — 1 skill

Folder	Skills	Scope
Overactive Bladder	1	Mirago (mirabegron) prescribing guide

---

🫘 Nephrology · 🫁 Respiratory · 🦴 Rheumatology — coming soon. Contributions welcome.

---

Repo Structure

MD2SKILL/
├── README.md
├── CONTRIBUTING.md
├── assets/
│   └── md2skill-logo.png
├── meta/
│   ├── md2skill-philosophy.md                       ← The 6-step pipeline
│   ├── md2skill-converter.md                        ← How to convert a guideline (native skill)
│   ├── chatgpt-md2skill-converter-system-prompt.md  ← Converter as a ChatGPT Custom GPT prompt
│   ├── chatgpt-custom-gpt-setup.md                  ← How to use skills in ChatGPT
│   └── chatgpt-master-system-prompt.md              ← Multi-skill GPT master prompt with citation rules
└── skills/
    ├── cardiology/lipidology/                       (1)
    ├── endocrinology/
    │   ├── adrenal/                                 (115)
    │   ├── calcium-disorders/                       (25)
    │   ├── cushing/                                 (45)  ← NEW
    │   ├── diabetes-in-pregnancy/                   (10)
    │   ├── diabetes-technology/                     (58)
    │   ├── gender-medicine/                         (26)  ← NEW
    │   ├── glp1-receptor-agonists/                  (17)
    │   ├── hypogonadism/                            (128)
    │   ├── inpatient-diabetes/                      (70)
    │   ├── lipidology/                              (52)
    │   ├── metabolic-bone/                          (23)
    │   ├── obesity/                                 (23)
    │   ├── pediatric-obesity/                       (34)
    │   ├── phaeochromocytoma/                       (70)
    │   ├── pituitary/                               (98)  ← NEW
    │   ├── preventive-care/                         (29)
    │   ├── t2dm/                                    (3)
    │   ├── thyroid-cancer/                          (4)
    │   ├── thyroid-nodule/                          (3)
    │   └── (plus loose HbA1c & comorbidity skills at root)
    ├── gastroenterology/
    │   ├── constipation/                            (3)
    │   └── glp1-endoscopy-pre-procedure/            (1)
    ├── genetics/nhs-genomic-test-finder/            (1, with CSV reference)
    ├── haematology/multiple-myeloma/                (3)
    ├── infectious-disease/diabetic-foot/            (2)
    ├── neurology/vestibular/                        (4)
    ├── pediatric-endocrinology/
    │   ├── cah/                                     (4)
    │   ├── growth/                                  (8)   ← NEW
    │   ├── pediatric-obesity/                       (6)
    │   └── puberty/                                 (3)   ← NEW
    ├── pediatric-medicine/                          (6, pediatric-obesity)
    ├── transplant-medicine/                         (2)
    └── urology/                                     (1)

Each skill folder:

skill-name/
├── SKILL.md             ← Claude
├── system-prompt.md     ← ChatGPT / Gemini / Perplexity / OpenClaw / any tool
└── README.md            ← What it does + how to use on each platform

---

How to Contribute

1. Pick a published guideline with a clear decision framework
2. Follow the methodology in meta/md2skill-converter.md
3. Build a step-by-step skill (not a summary)
4. Create SKILL.md (Claude) and system-prompt.md (universal)
5. Place in the correct specialty folder and submit a PR

See CONTRIBUTING.md for full instructions.

---

Disclaimer

These are clinical decision support tools, not autonomous diagnostic systems. They assist qualified healthcare professionals and do not replace clinical judgment or physical examination.

---

License

MIT — use freely in clinical practice, education, and product development.

Built by Dr. Om Lakhani

---

md2skill.org · GitHub