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.Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.
Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.
Efficient database search tool for bioRxiv preprint server. Use this skill when searching for life sciences preprints by keywords, authors, date ranges, or categories, retrieving paper metadata, downloading PDFs, or conducting literature reviews.
Query and analyze scholarly literature using the OpenAlex database. This skill should be used when searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publications, or conducting bibliometric analysis across 240M+ scholarly works. Use for literature searches, research output analysis, citation analysis, and academic database queries.
Access USPTO APIs for patent/trademark searches, examination history (PEDS), assignments, citations, office actions, TSDR, for IP analysis and prior art searches.
Multiagent AI system for scientific research assistance that automates research workflows from data analysis to publication. This skill should be used when generating research ideas from datasets, developing research methodologies, executing computational experiments, performing literature searches, or generating publication-ready papers in LaTeX format. Supports end-to-end research pipelines with customizable agent orchestration.
Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights with data-driven hypothesis testing. For manual hypothesis formulation use hypothesis-generation; for creative ideation use scientific-brainstorming.
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.