Skip to content

liliwen88/doctor.skill

Status License Platform Standard SkillsMP SkillHub

🏥 Family Health Doctor

Family Health Doctor — AI Medical Assistant Skill / 家庭保健医生 · AI医疗助手 / ファミリーヘルスドクター · AI医療アシスタント — Available on SkillsMP & Tencent SkillHub
Triage · Symptom Analysis (12 types) · Preventive Care (USPSTF+CDC) · Chronic Disease (6 guidelines) · Drug Info (OpenFDA+DailyMed+RxNorm) · Lab Report (Adult+Pediatric) · Pediatric Care · Literature Search · Clinical Trials · SOAP Notes

Quick StartFeaturesArchitectureAuthoritative Sources中文版日本語


⚠️ IMPORTANT DISCLAIMER: This skill provides information for reference purposes only and does NOT constitute professional medical advice, diagnosis, or treatment. Always consult qualified healthcare professionals for medical concerns. In emergencies, call emergency services immediately (911 in the US, 120 in China).


🎬 Demo

Here's what it looks like in action — 3 real-world scenarios:

🔴 Emergency: Chest Pain

🤖 YOU:
  I have sudden chest pain radiating to my
  left arm, with cold sweats. 55M, history
  of high blood pressure.

🩺 Doctor Skill:
  ### 🔴 症状分诊评估

  **分诊级别**:🔴 **紧急 — 立即就医**
  **置信度**:high

  **⚠️ 检测到的危险信号**:
  - 急性冠脉综合征 / Acute Coronary
    Syndrome

  **行动建议**:
  🔴 **立即呼叫急救**
  - 立即拨打 120/911
  - 嚼服阿司匹林 300mg(无禁忌)
  - 保持静卧,不要自行驾车

  🛑 紧急情况 — 停止所有进一步分析。

🟡 Routine: Back Pain

🤖 YOU:
  Lower back pain for 2 weeks, worse
  when sitting. No fever, no injury.
  35-year-old office worker.

🩺 Doctor Skill:
  ### 🟡 症状分诊评估

  **分诊级别**:🟡 **建议预约就诊**
  **置信度**:moderate

  **鉴别诊断**:
  - 腰肌劳损(可能性:高)
    → 物理治疗 + 核心肌群训练
  - 腰椎间盘突出(可能性:中)
    → 如出现下肢放射痛需 MRI

  **行动建议**:
  🟡 1 周内预约家庭医生
  - 就诊前记录症状日记
  - 避免久坐,定时起身活动

💊 Drug Interaction Check

🤖 YOU:
  I'm taking warfarin. Is it safe to
  take ibuprofen for my headache?

🩺 Doctor Skill:
  ### ⚠️ 严重药物相互作用

  **华法林 (Warfarin)** ↔ **布洛芬 (Ibuprofen)**

  **风险等级**:🔴 严重
  - 布洛芬增加华法林的抗凝作用
  - 显著增加消化道出血风险

  **建议**:
  - ❌ 避免同时使用
  - ✅ 可考虑对乙酰氨基酚(泰诺)
    作为替代方案

  **数据来源**:OpenFDA + DailyMed

📚 PubMed Literature Search

🤖 YOU:
  Find recent papers about AI in
  medical diagnosis from 2024-2025.

🩺 Doctor Skill:
  ### 📚 文献检索结果(5 篇)

  **1. AI in Clinical Diagnosis: A Review**
  - 作者:Smith J, et al.
  - 期刊:Lancet Digit Health (2025)
  - PMID: 12345678

  **2. Deep Learning for Radiology**
  - 作者:Chen L, et al.
  - 期刊:Nat Med (2024)
  - PMID: 23456789

  ...(共 5 篇,含摘要和全文链接)

🌐 Trilingual Quick Start

🇺🇸 EN · English

Preferred Platform: SkillsMP

npx skills add liliwen88/doctor.skill

Try it:

I've had a headache for 3 days
with fever and stiff neck
→ Triage → Symptom analysis
  with differential diagnosis

🇨🇳 中文 · Chinese

首选平台:腾讯 SkillHub

skillhub install doctor

试试看:

头痛3天,伴有发烧和颈部僵硬
→ 分诊评估 → 症状分析
  鉴别诊断报告

🇯🇵 日本語 · Japanese

推奨プラットフォーム: SkillsMP

npx skills add liliwen88/doctor.skill

お試し:

3日間の頭痛、発熱と首のこわばり
→ トリアージ → 症状分析
  鑑別診断レポート

✨ Features

# Feature Description Data Source
🔴 Triage System 4-level urgency assessment with ~30 red-flag patterns across 8 body systems Rule-based (ACEP/NICE)
🩺 Symptom Analysis 12 symptom types with structured differential diagnosis Knowledge Base + AI
🛡️ Preventive Care Personalized USPSTF A&B screening + CDC vaccination schedule by age/sex/risk USPSTF + CDC ACIP
💙 Chronic Disease Guideline-based targets for HTN, DM, lipids, asthma, COPD, hypothyroid ACC/AHA, ADA, GINA, GOLD, ATA
💊 Drug Information Drug details, interactions, multi-source fallback (OpenFDA+DailyMed+RxNorm) OpenFDA + DailyMed + RxNorm
📋 Lab Report Adult + pediatric reference ranges, 26+ tests, critical value detection Knowledge Base
👶 Pediatric Care Age-stratified lab ranges, growth milestones, fever triage (0-18y) AAP/NICE + WHO MGRS
📚 Literature Search PubMed + ClinicalTrials.gov search with structured results PubMed + ClinicalTrials.gov
📖 Terminology Bilingual medical terminology (EN/CN), preventive, pediatric, mental health Built-in Reference
✍️ SOAP Notes & Writing SOAP-format clinical documentation + patient education + health articles Templates + AI

🚀 Installation

From SkillsMP 🛒

SkillsMP is the largest Agent Skills marketplace with 1.2M+ skills.

# Using skills.sh CLI (recommended)
npx skills add liliwen88/doctor.skill

# Or via Claude Code
/plugin add https://github.com/liliwen88/doctor.skill

From Tencent SkillHub 🧩

腾讯 SkillHub is a Chinese AI Skills community optimized for China users.

# Install SkillHub CLI first
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# Search and install
skillhub search doctor
skillhub install doctor

Manual Installation

# Copy to your project (team-shared)
cp -r .github/skills/doctor /path/to/your/project/.github/skills/

# Or install globally (personal use)
cp -r .github/skills/doctor ~/.copilot/skills/doctor/

📖 Usage Examples

🔴 Triage (Always First)

Input:  I have sudden chest pain radiating to my left arm,
        with shortness of breath. 55-year-old male, history of HTN.
Output: 🔴 EMERGENCY — Call 911 immediately.
        Suspected acute coronary syndrome. Stop all further analysis.

🩺 Symptom Analysis

Input:  I've had lower back pain for 2 weeks, worse when sitting.
        No fever, no trauma history. 35-year-old office worker.
Output: 🟡 Non-urgent. Structured SOAP analysis with differential
        diagnoses (muscle strain, disc herniation, etc.) and follow-up plan.

💊 Drug Interaction Check

Input:  Check interaction between warfarin and ibuprofen.
Output: 💊 SEVERE interaction — increased bleeding risk.
        Avoid combination. Consider acetaminophen as alternative.
        Source: OpenFDA + DailyMed.

📚 PubMed Literature Search

Input:  Find recent papers about AI in medical diagnosis.
Output: 📚 Top 5 articles with titles, authors, journal,
        abstracts, and PMID links from PubMed.

🌐 Platform Compatibility

Platform Description Installation
SkillsMP Largest Agent Skills marketplace (1.2M+ skills) npx skills add liliwen88/doctor.skill
腾讯 SkillHub Tencent AI Skills community for China users skillhub install doctor
Claude Code Anthropic official CLI tool /plugin add <repo-url>
OpenAI Codex CLI OpenAI official CLI tool Copy to ~/.codex/skills/
Cursor AI-native code editor Project-level .cursor/skills/
VS Code Microsoft code editor (1.98+) Copy to .github/skills/
Manus Universal AI Agent One-click run from SkillsMP

🏗 Architecture

                         ┌──────────────┐
                         │   User Input  │
                         └──────┬────────┘
                                │
                    ┌───────────▼────────────┐
                    │  🔴 TRIAGE (Safety Gate) │
                    │  Emergency detection first │
                    └───────────┬────────────┘
                                │ (if non-emergency)
┌───────────────────────────────▼──────────────────────────────────┐
│                       SKILL.md (Router)                           │
│  10 features · 6 groups · SOAP output · Guideline-based          │
└──┬────────┬────────┬────────┬────────┬──────────┬───────────────┘
   │        │        │        │        │          │               │
   ▼        ▼        ▼        ▼        ▼          ▼
 Acute    Prev-    Chronic   Drug     Lab      Pediatric
 Care     entive   Disease   Info     Report   Care
   │        │        │        │        │          │               │
   ▼        ▼        ▼        ▼        ▼          ▼
Triage   USPSTF   ACC/AHA  OpenFDA  Ref.Ranges  WHO MGRS
Symptom  CDC      ADA       DailyMed  Adult +    AAP/NICE
Analyzer ACIP     GINA/GOLD RxNorm   Pediatric   Milestones
(12 types)        ATA
   │        │        │        │        │          │               │
   └────────┴────────┴────────┴────────┴──────────┴───────────────┘
                         │
                         ▼
              PubMed + ClinicalTrials.gov
                (Literature & Trials)

Project Structure

doctor.skill/
├── .github/skills/doctor/     # 🎯 Core Skill Package
│   ├── SKILL.md                # Main skill entry point (10 features)
│   ├── scripts/                # 9 Python API scripts (stdlib only)
│   ├── references/             # 12 medical reference files
│   └── assets/templates/       # 6 output templates
├── docs/                       # Full documentation
├── premium/                    # Premium features info
├── README.md                   # This file (EN)
├── README.zh-CN.md             # Chinese README
├── README.ja.md                # Japanese README
├── LICENSE                     # MIT License
└── ...

🛠 Technical Details

  • Standard: Agent Skills — open, portable format
  • APIs Used: PubMed E-utilities (free), OpenFDA (free), DailyMed (free), RxNorm (free), ClinicalTrials.gov API v2 (free)
  • Guidelines Embedded: USPSTF A&B, CDC ACIP, ACC/AHA, ADA, GINA, GOLD, ATA, AAP, NICE
  • Language: Python for API scripts (stdlib only), Markdown for knowledge base
  • Compatibility: SkillsMP · Tencent SkillHub · Claude Code · OpenAI Codex CLI · Cursor · VS Code 1.98+ · Manus · Any Agent Skills-compatible tool

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for details.

  • 🐛 Report bugs via Issues
  • 💡 Suggest features via Issues
  • ⚕️ Update medical knowledge references (guidelines, drug data, lab ranges)
  • 🌐 Help with translations (especially bilingual/trilingual content)
  • 💻 Improve API scripts (error handling, new data sources)

📈 Roadmap

v2.0 (Current) — Family Health Doctor

  • ✅ 10 core medical features including triage, preventive care, chronic disease management
  • ✅ 9 Python scripts, 12 reference files, 6 templates
  • ✅ Multi-source drug data (OpenFDA + DailyMed + RxNorm)
  • ✅ USPSTF A&B screening + CDC ACIP vaccination schedules
  • ✅ 6 chronic disease guideline-based targets (HTN, DM, lipids, asthma, COPD, hypothyroid)
  • ✅ Pediatric care (lab ranges, milestones, fever triage)
  • ✅ ClinicalTrials.gov API integration
  • ✅ SOAP-format clinical documentation
  • ✅ SkillsMP & Tencent SkillHub marketplace listing

v2.1 (Planned)

  • 🔄 Premium features (see premium/)
  • 🔄 FHIR-compatible data exchange
  • 🔄 Multi-language medical dictionary

📄 License

This project is licensed under the MIT License — see LICENSE for details.

⭐ Support

If you find this project useful, please consider:

  • Starring the repository ⭐
  • Sharing with colleagues and friends
  • Contributing code, knowledge, or documentation
  • Sponsoring via GitHub Sponsors

Built with ❤️ for healthcare and open source
Available on SkillsMP · 腾讯 SkillHub · Agent Skills open standard

About

Family Health Doctor — AI Medical Assistant Skill / 家庭保健医生 · AI医疗助手 / ファミリーヘルスドクター · AI医療アシスタント

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages