Skip to content
dromlakhaniPublic

About

Convert your MD to Skill.MD — AI-powered clinical decision support skills from medical guidelines

Resources

Contributing

Stars

14 stars

Watchers

0 watching

Forks

Latest commit

 

History

61 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MD2SKILL Logo

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.

910 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(Skills)"]
    F --> H["ChatGPT\n(Skills)"]
    F --> I["Gemini\n(Skills)"]
    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

What changed in 2026: SKILL.md is now an open standard (Agent Skills). Claude, ChatGPT and Gemini all read the same file natively, so one MD2SKILL skill now works across all three without rewriting.

Each skill has two files:

File For
SKILL.md Claude · ChatGPT · Gemini · OpenClaw · Perplexity Computer — native skill install; the AI reads the name and description first and opens the full skill only when your case needs it
system-prompt.md Older setups (ChatGPT Custom GPTs / Projects, Perplexity Spaces, or accounts without Skills yet) — paste as Instructions; always on

How to use SKILL.md on each platform

Platform How to add a skill How it runs
Claude (claude.ai / desktop) Settings → Capabilities → Skills → upload the skill folder as a .zip Auto-triggers from the description
Claude Code / Cowork Drop the folder into .claude/skills/<skill-name>/ Auto-triggers from the description
ChatGPT Plugins → Skills → Create → Upload from computer (Enterprise / Edu: Plugins in the sidebar → Skills tab) Auto-triggers from the description
Gemini app Upload SKILL.md as a new skill (web and Mac apps for now). Skills replace Gems. Call it with /skill-name in the chat
Gemini CLI / Antigravity Place the skill folder in the CLI's skills directory Auto-triggers; can use scripts and reference files
OpenClaw / Perplexity Computer Install via the platform's skill installer Auto-triggers

Notes

  • Availability varies by plan and is still rolling out (ChatGPT Skills started mid-2026; Gemini skills from late September 2026). If Skills aren't on your account yet, use system-prompt.md below.
  • Gems → Skills: Google is retiring Gems in favour of skills. Personal-account dates and Workspace dates differ; check Google's help pages. Existing Gem setups using system-prompt.md keep working until then.
  • Gemini app skills are lighter: they behave like / shortcuts and don't run scripts. A skill that needs a calculator script works fully only in Claude, ChatGPT or Gemini CLI.
  • Safety: a skill acts with your permissions, and SKILL.md files can hide instructions (including invisible characters). Only install skills whose SKILL.md you have read. Every MD2SKILL skill is plain, readable Markdown with its guideline source cited.

Use with ChatGPT Custom GPTs (legacy)

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).


system-prompt.md — Paste as Instructions (fallback)

Use this when native Skills aren't available on your account, or for a single always-on assistant.

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

Skills Library

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

🩺 Endocrinology — 842 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 HbA1c targets & intensification (NICE NG28 2026)
T2DM — HbA1c Target & Intensification 1 Individualised HbA1c target-setting and intensification triggers for adults with T2DM (NICE NG28 2026)
T2DM — Comorbidity Medicine Selector 1 Comorbidity-stratified glucose-lowering medicine selection for T2DM — six clinical profiles (NICE NG28 2026)
Weekly Insulin 3 Awiqli (insulin icodec) prescribing guide, switching from daily basal, hypoglycaemia & safety
Pancreatic Exocrine Insufficiency 2 Diabetes therapy adjustment when starting PERT, PERT start & titration in diabetes (Indian expert consensus 2026)
Type 1 Diabetes 4 Islet autoantibody screening & confirmation, staging classifier (At Risk → Stage 4), progression risk & monitoring frequency, teplizumab eligibility & 14-day course (Hussain et al 2026, IDF Europe consensus)

🧒 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 — 7 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
MASLD 2 MASLD fibrosis risk stratification (FIB-4 → elastography), FibroScan report interpretation (EASL-EASD-EASO 2024)
Pancreatic Exocrine Insufficiency 1 PERT start & titration in diabetes with PEI (Indian expert consensus 2026)

🩸 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 — 14 skills

Sub-specialty Skills Scope
Hypertension 7 ISH 2026 — diagnosis & BP measurement, treatment drug strategy, children, resistant & secondary, emergency, pregnancy, risk assessment & workup
Lipidology 6 ASCVD risk calculator, LDL treatment goals, CPR dyslipidemia framework, CAC scoring indication, Lp(a) screening & cascade, Bemdec prescribing guide
Inherited CVD Genetics 1 Genetic testing order checklist for inherited cardiovascular disease (JCS/JCC/JSPCCS 2024)

🧬 Genetics & Genomics — 2 skills

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)
Cancer Predisposition 1 WB-MRI surveillance plan selection for cancer predisposition syndromes (Summers et al. 2021)

🚽 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/
    │   ├── hypertension/                            (7)
    │   ├── inherited-cvd-genetics/                  (1)
    │   └── lipidology/                              (6)
    ├── endocrinology/
    │   ├── adrenal/                                 (115)
    │   ├── calcium-disorders/                       (25)
    │   ├── cushing/                                 (45)
    │   ├── diabetes-in-pregnancy/                   (10)
    │   ├── diabetes-technology/                     (58)
    │   ├── gender-medicine/                         (26)
    │   ├── glp1-receptor-agonists/                  (17)
    │   ├── hypogonadism/                            (128)
    │   ├── inpatient-diabetes/                      (70)
    │   ├── lipidology/                              (52)
    │   ├── metabolic-bone/                          (23)
    │   ├── obesity/                                 (23)
    │   ├── pancreatic-exocrine-insufficiency/       (2)
    │   ├── pediatric-obesity/                       (34)
    │   ├── phaeochromocytoma/                       (70)
    │   ├── pituitary/                               (98)
    │   ├── preventive-care/                         (29)
    │   ├── t1d/                                     (4)
    │   ├── t2dm/                                    (1)
    │   ├── t2dm-comorbidity-medicine-selector/      (1)
    │   ├── t2dm-hba1c-target-and-intensification/   (1)
    │   ├── thyroid-cancer/                          (4)
    │   ├── thyroid-nodule/                          (3)
    │   └── weekly-insulin/                          (3)
    ├── gastroenterology/
    │   ├── constipation/                            (3)
    │   ├── glp1-endoscopy-pre-procedure/            (1)
    │   ├── masld/                                   (2)
    │   └── pancreatic-exocrine-insufficiency/       (1)
    ├── genetics/
    │   ├── cancer-predisposition/                   (1)
    │   └── nhs-genomic-test-finder/                 (1)
    ├── haematology/multiple-myeloma/                (3)
    ├── infectious-disease/diabetic-foot/            (2)
    ├── neurology/vestibular/                        (4)
    ├── pediatric-endocrinology/
    │   ├── cah/                                     (4)
    │   ├── growth/                                  (8)
    │   ├── growth-hormone/                          (6)
    │   ├── pediatric-obesity/                       (6)
    │   └── puberty/                                 (3)
    ├── pediatric-medicine/                          (6)
    ├── 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
md2skill.org · GitHub

About

Convert your MD to Skill.MD — AI-powered clinical decision support skills from medical guidelines

Resources

Contributing

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors