asgard-ai-platform/med-health
Use when writing a medical or health news story — clinical research breakthroughs, public health alerts, drug approvals, epidemiology, health policy, patient stories, risk communication — from research papers, press releases, health authority statements, or interviews. Specializes the med-news-reporter workflow for health-beat discipline: relative risk framing, absolute baseline inclusion, evidence-hierarchy verification, deidentification protocol, and WHO suicide-reporting compliance. Triggers on phrases like '寫一篇醫學新研究', 'draft a health news piece', '整理流行病新聞', '幫我把這份臨床試驗結果寫成新聞', '健康新聞報導', 'write up this drug approval', 'health story from this study'. Do NOT use for medical advice (→ consult healthcare provider), pharmaceutical marketing (→ mkt-pharma), hospital PR/press release in house voice (→ pr-press-release).
npx skills add https://github.com/asgard-ai-platform/skills --skill med-health
> This skill specializes med-news-reporter for the medical/health beat. Read med-news-reporter first for the general 6-step workflow (type selection, material audit, fact-check, balance, ethics, literacy). This file adds health-specific discipline on top.
Distilled from health-journalism curricula at Stanford Medicine+Muse, Johns Hopkins SFDH, AHCJ (Association of Health Care Journalists), Columbia Mailman, NTU Public Health, and Taiwan health-media ethics standards. Covers five sub-types: research breakthroughs / public-health alerts / drug approval / health policy / patient stories. Core challenge: translating statistical evidence for public understanding without misrepresenting risk or false certainty.
IRON LAW: Relative Risk Without Absolute Risk Is Misleading
Every medical claim in the form "X% increase/decrease in risk" MUST cite
absolute baseline numbers: baseline incidence, NNT (Number Needed to Treat),
absolute risk reduction, or absolute risk change. "50% reduction in risk of
heart attack" is meaningless without "from 4 in 1000 to 2 in 1000 per year".
LLM default: lead with the relative risk (sounds dramatic), omit baseline.
Readers then overestimate the clinical significance. Override that default
by naming the denominator first, then the percentage.
Why this is non-obvious: "50% reduction" *sounds* much more impactful than "2 fewer heart attacks per 1000 per year", yet both describe the same result. Research-to-media translation routinely inverts this — the press release says "50% reduction", the outlet runs that number, and readers assume a larger clinical effect than evidence supports. This is the single most common source of health-news overclaim.
Rationalization Table — these justifications DO NOT override the Iron Law:
| Claude might think... | Why it's still a violation |
|---|---|
| "'50% reduction' is the research result, I'll just quote it" | Quoting a relative-risk figure *without* the absolute baseline is relaying an incomplete fact. The journal paper has the baseline; the press release usually does not. Cite both or cite neither + flag. |
| "The baseline is in the methods section, readers can look it up" | Readers will not. The article is the only context they read. Omitting it is misleading by omission, not just incomplete. |
| "Adding the absolute number makes the story less dramatic" | That is the *point*. Accuracy is not a bug. If the absolute effect is small, the reader deserves to know. |
| "NNT is too technical for general audiences" | True, and it's also the clearest way to show clinical significance. Use NNT in a side sentence ('meaning doctors would need to treat about 500 people to prevent one case'). Not optional. |
| "The researcher said 'statistically significant'—that's the main story" | Statistically significant ≠ clinically significant. A study of 100,000 people can show a 0.5% effect as "significant" if it's real. Report both p-value and effect size. |
Trigger conditions:
Input signals:
When NOT to use:
pr-press-release.pr-*.Read or have already loaded med-news-reporter for: material audit, fact-checking, source-strength tagging, balance principle, media-ethics check, media-literacy self-check. Do not re-implement those steps here. This file specializes Steps 1, 2, 3, and adds health-specific Step 7 (Evidence Hierarchy & Risk Framing Audit).
| Sub-type | Signals | Sub-template focus |
|----------|---------|--------------------|
| Research breakthrough | Journal paper, pre-print, press release from university/NIH | Evidence level check; RR + AR framing; replication status |
| Public health alert | CDC alert, 衛福部 advisory, WHO statement, disease outbreak | Absolute numbers (cases, deaths); transmission risk; at-risk population; response guidance |
| Drug approval | FDA/食藥署 approval, Phase III completion, clinical trial results | Trial design rigor; efficacy + side-effect rate; NNT; cost/access; alternative treatments |
| Health policy | Coverage decision, vaccine recommendation, screening guideline, regulation | Policy rationale; affected population; evidence basis; expert consensus; dissenting opinion |
| Patient story | Interview, testimonial, case narrative | De-identification protocol; generalizability limits; attribution; expert context |
If material spans sub-types (e.g. a policy change triggered by a study), classify by the *primary news driver*.
Every health claim must carry evidence-level tag at first mention:
Evidence Hierarchy (strongest → weakest):
1. Meta-analysis / systematic review of RCTs
2. Large RCT (n > 500)
3. Small RCT (n < 500)
4. Cohort study / case-control study
5. Case series / case report
6. Expert opinion / editorials
7. Anecdote / single patient story
Bad tagging: 「新研究表示...」(which study? what strength?)
Good tagging: 「今年發表在 Lancet 的一項 1,200 人隨機對照試驗表示...」or 「基於個案報告(證據等級 5)...但尚未進行人體試驗」
Source tier (extends med-news-reporter):
| Tier | Examples | Treatment |
|------|----------|-----------|
| Government health authority | CDC, 衛福部、疾管署、食藥署、WHO | Direct citation; highest credibility tier |
| Peer-reviewed journal | Lancet, JAMA, BMJ, Nature Medicine, 台灣醫學會期刊 | Always cite journal name + DOI; include publication date |
| Preprint / not yet peer-reviewed | medRxiv, bioRxiv | Must flag as "not yet peer-reviewed"; requires editor review before publication |
| University press release | Without access to actual paper | Treat as Tier 2.5; verify against journal preprint / abstract |
| Single researcher quote | Without published evidence | Tier 4; acceptable only as "expert opinion" with explicit caveat |
| Pharmaceutical company | Clinical trial sponsor | Tier 3–4; always disclose funding source; cross-verify against independent data when possible |
| Patient anecdote | Interview, testimonial, Facebook post | Tier 7; only acceptable as illustrative narrative, never as evidence |
Beyond med-news-reporter's general ethics check, add:
Before output, apply:
Use the med-news-reporter base format, with health-specific additions to the meta footer:
[Headline / sub-headline / body paragraphs per med-news-reporter]
---
**稿件類型**: 醫學研究報導 / 公衛警訊 / 藥品核准 / 健康政策 / 患者故事
**字數**: approx. XXX
**消息來源層級**: 政府公衛機構 N / 同儕評審期刊 N / 預印本 N / 企業新聞稿 N / 專家意見 N / 患者訪談 N
**醫學證據稽核**:
- 每項醫學宣稱之證據等級: ✅ / ⚠️ (列出未標的)
- 相對風險 + 絕對風險配對: ✅ / ⚠️ (列出缺項: RR 未伴絕對值、NNT、基礎風險)
- 單一研究 vs 系統性評論: ✅ / N/A / ⚠️
- 95% CI / 不確定性表述: ✅ / ⚠️ (列出未含的宣稱)
**患者隱私檢核**:
- 去識別化: ✅ / ⚠️ (列出仍可追蹤身份的資訊)
- 同意書揭露: ✅ / N/A / ⚠️
**WHO 自殺守則**:
- 適用: N/A / ✅ (已遵守) / ❌ (違反項目)
**利益衝突揭露**:
- 資金來源: ✅ / N/A / ⚠️ (列出未揭露的利益相關)
**待查證事項**: ...
**倫理 / 識讀檢核摘要**: 〔交給 med-news-reporter 的 Step 4-5 footer〕
See examples/ directory for:
sample_input.md — realistic health-news source material (clinical study press release + health authority statement + medical society response + patient anecdote)sample_output.md — produced piece + meta footer + skill-trace explanation| File | Purpose | When to read |
|------|---------|--------------|
| references/sources_and_beats.md | 台灣衛生醫療消息來源、機構、官方資料庫 | Step 2 source vetting |
| references/glossary.md | 醫學統計、流行病學、臨床試驗術語對照 | When unfamiliar medical terminology appears |
| references/ethics_and_law.md | PDPA / 醫療法 §72 / 醫療廣告法 / 自殺守則 | Step 3 risk check |
| references/medical_evidence_reading.md | 證據等級金字塔、相對風險誤導、P-hacking | Step 1/4 evidence hierarchy |
| references/risk_communication.md | 風險溝通原則、絕對 vs 相對、不確定性表述 | Step 4 risk framing |
Related skills:
med-news-reporter — general news workflow (this skill specializes it)med-political — health policy & regulatory newsstat-hypothesis-testing — deeper statistical literacy on RCTs and meta-analysesstat-causal-inference — for causation claims in observational studieshum-source-criticism — source vetting frameworksreferences/medical_evidence_reading.md, but for deep methodological critique use stat-hypothesis-testing or grad-survey-design.Take asgard-ai-platform/med-health from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.