doctorg — Claude Code skill: evidence-based health research
doctorg is a Claude Code skill that answers health, nutrition, training and sleep questions by checking trusted sources and grading the strength of evidence for each claim.
MIT 265 installs ★ 414 updated 2026-10-23
npx skills add glebis/claude-skills --skill doctorg -a claude-codeWhat doctorg does
The skill searches at three depth levels: quick (/doctorg) checks primary research and clinical sources in thirty seconds, deep (--deep) adds Tavily and expert sources in ninety seconds, full (--full) pulls full texts through Firecrawl in three minutes. Each claim gets a rating — Strong, Moderate, Weak, Minimal or Contested — based on meta-analyses, RCTs or expert opinion.
Sources are divided into four tiers: primary research (PubMed, Cochrane), clinical institutions (Mayo Clinic, Hopkins), expert analysis (Examine.com, Consensus.app) and quality journalism. The --no-personal flag disables pulling data from Apple Health; without it, the skill considers your heart rate, sleep, workouts and weight.
Without the health_query.py Python script, personal context will not work. Deep and full modes require Tavily and Firecrawl tokens.
What it helps with
- compare conflicting advice from two experts on the same question
- find systematic reviews on supplement safety
- get a recommendation based on your Apple Health metrics
- assess the strength of evidence for a controversial treatment
Example prompts for the agent
- Is creatine safe for daily use?
- Huberman vs Attia on fasted training — run
--deep - What does current evidence say about GLP-1 agonists for non-diabetic weight loss? Run
--full
How to install doctorg
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill doctorg -a claude-code2Manually: put the files in place
~/.claude/skills/doctorg/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/doctorg/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill doctorg -a codex2Manually: put the files in place
.agents/skills/doctorg/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill doctorg -a cursor2Manually: put the files in place
.cursor/skills/doctorg/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install glebis/claude-skills doctorg2Manually: put the files in place
.github/skills/doctorg/SKILL.md1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill doctorg -a gemini-cli2Platform CLI
gemini skills install https://github.com/glebis/claude-skills --path doctorgManually: put the files in place
.devin/skills/doctorg/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill doctorg -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about doctorg
How to install doctorg in Claude Code?
Run npx skills add glebis/claude-skills --skill doctorg -a claude-code, the skill will be placed in ~/.claude/skills/doctorg/SKILL.md.
What does doctorg do?
Searches for answers to health questions in trusted sources — PubMed, Cochrane, clinical institutions — and grades the strength of evidence for each claim. Can incorporate data from Apple Health.
Which sources does doctorg use?
Tier 1 — PubMed, Cochrane, WHO, ClinicalTrials.gov. Tier 2 — Mayo Clinic, Hopkins, Cleveland Clinic, Harvard, condition-specific associations like AHA and ADA. Tier 3 — Examine.com, Consensus.app, Epistemonikos. Tier 4 — The Atlantic, NYT, NPR, Guardian.
Source text
SKILL.md · MIT
--- name: doctorg description: Evidence-based health research using tiered trusted sources with GRADE-inspired evidence ratings. Integrates Apple Health data for personalized context. Use when user asks health, nutrition, exercise, sleep, or wellness questions. --- # Doctor G -- Evidence-Based Health Research Answer health and wellness questions using only trusted, evidence-based sources with explicit evidence strength ratings. ## Usage ```bash # Quick answer (WebSearch only, ~30s) /doctorg Is creatine safe for daily use? # Deep research (WebSearch + Tavily, ~90s) /doctorg --deep Huberman vs Attia on fasted training # Full investigation (WebSearch + Tavily + Firecrawl, ~3min) /doctorg --full What does current evidence say about GLP-1 agonists for non-diabetic weight loss? # Without personal health context /doctorg --no-personal Best stretching protocol for lower back pain ``` ## Depth Levels | Level | Flag | Tools | Time | Use When | |-------|------|-------|------|----------| | Quick | *(default)* | WebSearch | ~30s | Simple factual questions | | Deep | `--deep` | WebSearch + Tavily | ~90s | Competing claims, nuanced topics | | Full | `--full` | WebSearch + Tavily + Firecrawl | ~3min | Controversial topics, need primary sources | ## How It Works ### 1. Parse Query & Detect Topic Category Classify the question into one of: - **Nutrition/Supplements** (examine.com gets priority) - **Exercise/Training** (PubMed + ACSM get priority) - **Sleep** (focus sleep-specific databases) - **Disease/Condition** (condition-specific orgs + clinical guidelines) - **Medication/Treatment** (FDA, EMA, Cochrane get priority) - **Mental Health** (APA, mental health orgs) - **General Wellness** (broad search across all tiers) ### 2. Search Evidence Sources (Tiered) Search sources in priority order. See `references/sources.md` for complete domain list. **Tier 1 -- Primary Research** (highest weight): - PubMed/PMC, Cochrane Library, WHO, ClinicalTrials.gov **Tier 2 -- Clinical/Institutional** (high weight): - Mayo Clinic, Hopkins Medicine, Cleveland Clinic, Harvard Health - Condition-specific: AHA, ACS, ADA, Alzheimer's Association **Tier 3 -- Expert Analysis** (medium weight): - Examine.com, STAT News, Health News Review - Consensus.app, Epistemonikos **Tier 4 -- Quality Journalism** (context/framing): - The Atlantic, NYT, NPR, Guardian, FiveThirtyEight #### Search Strategy by Depth **Quick** (default): ``` WebSearch(query, allowed_domains=[Tier 1 + Tier 2 domains]) WebSearch(query + "systematic review OR meta-analysis", allowed_domains=[Tier 1]) ``` **Deep** (--deep): All Quick searches PLUS: ``` tavily-search(query, include_domains=[Tier 1-3]) WebSearch(query + "expert opinion OR position statement", allowed_domains=[Tier 2-3]) WebSearch(query + "risks OR side effects OR contraindications") ``` **Full** (--full): All Deep searches PLUS: ``` firecrawl-research for top 2-3 most relevant results from Tier 1 WebSearch for competing/contrarian viewpoints WebSearch(query + "retracted OR debunked OR misleading") ``` ### 3. Pull Personal Health Context (unless --no-personal) Query Apple Health database for relevant metrics: ```bash python ~/ai_projects/claude-skills/health-data/scripts/health_query.py --format json vitals python ~/ai_projects/claude-skills/health-data/scripts/health_query.py --format json daily python ~/ai_projects/claude-skills/health-data/scripts/health_query.py --format json sleep --days 7 python ~/ai_projects/claude-skills/health-data/scripts/health_query.py --format json workouts --days 30 ``` Select ONLY metrics relevant to the query: - Exercise question -> recent workouts, activity, resting HR, VO2 max - Sleep question -> sleep data, HRV - Nutrition question -> weight trends, activity level - Heart question -> HR, HRV, resting HR, blood pressure ### 4. Synthesize with Evidence Grading Rate each claim using simplified GRADE scale: | Rating | Meaning | Based On | |--------|---------|----------| | **Strong** | Consistent evidence from systematic reviews/meta-analyses or multiple large RCTs | Level I-II evidence | | **Moderate** | Supported by well-designed studies but some inconsistency or limitations | Level II-III evidence | | **Weak** | Limited evidence, small studies, or conflicting results | Level III-IV evidence | | **Minimal** | Expert opinion, case reports, or preliminary/animal studies only | Level V evidence | | **Contested** | Active scientific debate with credible evidence on both sides | Mixed levels | ### 5. Format Output ```markdown # [Topic Title] **Short answer**: [1-2 sentence direct answer] ## [Expert/Position A] (if comparing viewpoints) - Key claim 1 - Key claim 2 - Has **evolved stance**: [if applicable] ## [Expert/Position B] - Key claim 1 - Key claim 2 ## Where They Actually Agree (if comparing) - Agreement point 1 - Agreement point 2 ## What Research Shows | Claim | Evidence Strength | |-------|------------------| | Claim 1 | **Strong** | | Claim 2 | **Weak** (reason) | | Claim 3 | **Contested** | ## For You Specifically (if --personal context available) [Personalized interpretation based on user's health data] [Specific actionable recommendation] ## Sources - [Source 1 title](url) -- Tier, year - [Source 2 title](url) -- Tier, year ## Limitations - [Any caveats about the evidence or this analysis] ``` **Output rules**: - NEVER give medical diagnoses or replace professional advice - ALWAYS include disclaimer: "This is research synthesis, not medical advice" - When evidence is **Weak** or **Minimal**, explicitly say so - When claims are **Contested**, present both sides fairly - Prefer recent sources (last 5 years) over older ones - Flag if key studies have been retracted or challenged - Include the "For You Specifically" section only when health data adds meaningful context ### 6. Disclaimer (always append) ``` --- *Research synthesis, not medical advice. Consult a healthcare provider for personal decisions.* ``` ## Examples ### Quick ``` /doctorg Is 10000 steps a day backed by science? ``` ### Deep (comparing experts) ``` /doctorg --deep Huberman vs Attia on fasted training ``` ### Full (controversial topic) ``` /doctorg --full Safety profile of long-term melatonin supplementation ``` ## Integration with Other Skills - **health-data**: Pulls Apple Health metrics for personalization - **tavily-search**: Deep research at Tier 1-3 sources - **firecrawl-research**: Full-text extraction from primary sources - **fact-checker**: Can be chained for verification of specific claims
© glebis · MIT · glebis/claude-skills