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
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.
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
Full methodology:
meta/md2skill-philosophy.md· Skill builder:meta/md2skill-converter.md
What changed in 2026:
SKILL.mdis 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 |
| 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.mdbelow. - 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.mdkeep 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.mdfiles can hide instructions (including invisible characters). Only install skills whoseSKILL.mdyou have read. Every MD2SKILL skill is plain, readable Markdown with its guideline source cited.
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).
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 |
910 skills across 11 specialties. The tables below show coverage by sub-specialty — click any folder link to browse the skills inside.
| 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) |
| 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 |
| Folder | Skills | Scope |
|---|---|---|
| Pediatric Obesity | 6 | Cross-listed CMAJ 2025 set for non-endocrine pediatric workflow |
| Sub-specialty | Skills | Scope |
|---|---|---|
| Vestibular / Dizziness | 4 | Dizziness type classifier, red-flag screener, peripheral vs central vertigo, BPPV differential |
| 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) |
| Sub-specialty | Skills | Scope |
|---|---|---|
| Multiple Myeloma | 3 | Diagnostic workup, ASCT eligibility, MRD assessment |
| Folder | Skills | Scope |
|---|---|---|
| Kidney Transplant | 2 | DBD donor eligibility (DM/HTN), MAPI score calculator |
| Sub-specialty | Skills | Scope |
|---|---|---|
| Diabetic Foot | 2 | IWGDF/IDSA 2023 — severity classifier, empiric antibiotic selector |
| 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) |
| 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) |
| Folder | Skills | Scope |
|---|---|---|
| Overactive Bladder | 1 | Mirago (mirabegron) prescribing guide |
🫘 Nephrology · 🫁 Respiratory · 🦴 Rheumatology — coming soon. Contributions welcome.
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
- Pick a published guideline with a clear decision framework
- Follow the methodology in
meta/md2skill-converter.md - Build a step-by-step skill (not a summary)
- Create
SKILL.md(Claude) andsystem-prompt.md(universal) - Place in the correct specialty folder and submit a PR
See CONTRIBUTING.md for full instructions.
These are clinical decision support tools, not autonomous diagnostic systems. They assist qualified healthcare professionals and do not replace clinical judgment or physical examination.
MIT — use freely in clinical practice, education, and product development.
Built by Dr. Om Lakhani
