Agent skill

Faers Safety Scan

by hh-health-AI in hh-health-AI/healthcare-equity

This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label…

MITAuto-check passed

Install Faers Safety Scan

skills CLI
$ npx skills add hh-health-AI/healthcare-equity --skill faers-safety-scan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hh-health-AI/healthcare-equity faers-safety-scan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hh-health-AI/healthcare-equity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/modules/fda-safety-signals/skills/faers-safety-scan .claude/skills/faers-safety-scan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
faers-safety-scan
GitHub stars
101
Token cost
~843 tokens
SKILL.md length
449 words
Files
2 (incl. references)
Skills in repo
72
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label…

  • Works in 9 steps: Define the comparator before you pull… → Define the event term precisely. MedDRA… → Set a time window and hold it constant… → …
  • Asks about FAERS
  • SKILL.md covers Workflow, What escalation actually looks… and Not-automatic
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Faers Safety Scan is an agent skill from hh-health-AI/healthcare-equity. This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label change risk", or wants to screen post-market safety reporting for a marketed drug against a comparator.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/disproportionality.md`).

The repository describes itself as: Synthesis engine for buy-side healthcare equity research. The licence is MIT.

When your agent uses it

  • Asks about FAERS
  • Adverse event signal
  • Disproportionality
  • Is there a signal on [drug]

Example prompts

  • “adverse event signal”
  • “disproportionality”
  • “safety short”
  • “/faers-safety-scan”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Define the comparator before you pull anything. The default of "all other
  2. Define the event term precisely. MedDRA preferred terms are narrow. A "liver
  3. Set a time window and hold it constant across drug and comparator. Reporting
  4. Run scripts/faers_disproportionality.py. It builds the 2×2 and returns PRR,
  5. Apply the Evans screening criteria (a ≥ 3 cases, PRR ≥ 2, chi-square ≥ 4). All
  6. Test for notoriety. Plot reports by quarter. If the rise begins within a quarter
  7. Check what FDA has already done. Search the current label (openFDA /drug/label)
  8. Size the exposure. Which revenue line, what share of it, and what an analogue
  9. Emit the brief.

What it can do on your machine

Read from SKILL.md and the folder at commit 6c7bda8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Faers Safety Scan loads about 843 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 449 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~843
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hh-health-AI/healthcare-equity at commit 6c7bda8, republished under its MIT licence (© hh-health-AI). 449 words, ~843 tokens.

Download SKILL.mdSave it as .claude/skills/faers-safety-scan/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
faers-safety-scan
description
This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label change risk", or wants to screen post-market safety reporting for a marketed drug against a comparator.
metadata.version
0.1.0
metadata.layer
Regulatory

FAERS safety scan

Screen a marketed drug's adverse-event reporting for disproportionate signals, size the commercial exposure if the signal escalates, and be explicit that this is a screen rather than a finding.

Workflow

  1. Define the comparator before you pull anything. The default of "all other drugs in FAERS" is almost always the wrong comparator for an investment question, because it confounds the indication. Prefer: other drugs in the same class, or drugs treating the same indication. State the comparator in the brief.
  2. Define the event term precisely. MedDRA preferred terms are narrow. A "liver injury" question needs a term list (hepatotoxicity, hepatic failure, ALT increased, jaundice, drug-induced liver injury), not one term. Run the list, report per-term and aggregated, and show the list in the output.
  3. Set a time window and hold it constant across drug and comparator. Reporting volume grows secularly, so an unwindowed comparison favours older drugs.
  4. Run scripts/faers_disproportionality.py. It builds the 2×2 and returns PRR, ROR with 95% CI, chi-square with Yates correction, and the Evans criteria flag.
  5. Apply the Evans screening criteria (a ≥ 3 cases, PRR ≥ 2, chi-square ≥ 4). All three, not one. A PRR of 8 on two cases is noise.
  6. Test for notoriety. Plot reports by quarter. If the rise begins within a quarter of a publication, an FDA communication, a competitor's marketing campaign or plaintiff-firm advertising, discount it heavily and say so.
  7. Check what FDA has already done. Search the current label (openFDA /drug/label) for the event. If it is already in Warnings and Precautions, the incremental news is an escalation to boxed warning or a REMS, not the signal itself — a much higher bar.
  8. Size the exposure. Which revenue line, what share of it, and what an analogue label change did to comparable franchises. This is where the skill earns its keep; a signal with no revenue attached is not an investment.
  9. Emit the brief.
Show full SKILL.md (127 more words)Show less

What escalation actually looks like

The path from FAERS signal to a stock-moving event is long and mostly does not complete: signal → FDA screening (FAERS quarterly signal listing) → Drug Safety Communication → label change → boxed warning → REMS → withdrawal. Each step is progressively rarer. Position for the step you can name and date, not for the end of the chain.

The FDA's own quarterly "Potential Signals of Serious Risks" listing is public and is a far stronger signal than a home-built PRR, because it means the agency is already looking. Check it before building your own.

Not-automatic

A disproportionate reporting ratio does not license a causality claim, an incidence estimate, or a forecast of regulatory action. It licenses a monitor with a named follow-up observable.

Reference: references/disproportionality.md. Contract: ../../references/evidence-brief.md.

© hh-health-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in modules/fda-safety-signals/skills/faers-safety-scan of hh-health-AI/healthcare-equity.

  • SKILL.md
  • references/disproportionality.md

Open the folder on GitHubat commit 6c7bda8

Compare with similar skills

Faers Safety Scan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Faers Safety Scan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Faers Safety Scan this skillhh-health-AI/healthcare-equity101—~843Automated safety check: PassMIT
Safety Scanruvnet/ruflo74k—~409Automated safety check: NotesMIT
Scanwshobson/agents40k—~2.2kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.5kAutomated safety check: PassMIT
Repo Scanaffaan-m/ECC276k—~1.3kAutomated safety check: PassMIT
Vulnerability Scanningsickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT

Similar skills

  • Safety Scan

    ruvnet/ruflo

    Scan inputs for prompt injection, unsafe content, and adversarial attacks using AIDefence.

    74k GitHub stars~409 tokensUpdated yesterday
    SecurityAuto-check: notes
  • Scan

    wshobson/agents

    Scans the codebase to generate project-doc.md and AGENTS.md.

    40k GitHub stars~2.2k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Repo Scan

    affaan-m/ECC

    固定されレビュー可能なコミットから外部の repo-scan スキルをインストールするブートストラップ用ポインター。クロススタックのソースコード資産監査を実行する前に repo-scan のインストールが必要な場合に使用する。この ECC ポインター自体は監査を実行しない。

    276k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Repo Scan

    affaan-m/ECC

    用于从固定且可审查的提交安装外部 repo-scan 技能的引导指针。在运行跨栈源代码资产审计前需要安装 repo-scan 时使用;此 ECC 指针本身不执行审计。

    276k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Vulnerability Scanning

    sickn33/agentic-awesome-skills

    Scan systems and dependencies for CVEs and security vulnerabilities.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    SecurityAuto-check passed
  • Repo Scan

    affaan-m/ECC

    Bootstrap pointer that installs the external repo-scan skill from a pinned, reviewable commit.

    277k GitHub starsUsed in 1 repo~1.8k tokens
    DevelopmentAuto-check passed

More from hh-health-AI/healthcare-equity

All 72 skills in this repo
  • Adcom Label

    hh-health-AI/healthcare-equity

    This skill should be used when the user says "prep the AdCom for [asset]", "what will the advisory committee vote", "analyze the approved label", "label delta vs expectations", or within 48 hours of…

    101 GitHub stars~1.1k tokensUpdated 3 days ago
    Auto-check passed
  • Biomedical Claim Checker

    hh-health-AI/healthcare-equity

    A skill your agent uses to audit whether medical or scientific claims are supported by their citations, verify references, assess AI-generated biomedical text or identify overstatement in a press…

    101 GitHub stars~741 tokensUpdated 3 days ago
    Auto-check passed
  • Biomedical Claim Checker

    hh-health-AI/healthcare-equity

    A skill your agent uses when checking whether a medical or scientific claim is supported by its cited paper, verifying references, auditing an AI-generated biomedical answer or examining…

    101 GitHub stars~816 tokensUpdated 3 days ago
    Auto-check passed
  • Biosimilar Erosion

    hh-health-AI/healthcare-equity

    This skill should be used when the user asks about "biosimilar erosion", "Purple Book", "biologic exclusivity", "interchangeability", "how fast will [biologic] erode", "erosion curve", or needs the…

    101 GitHub stars~753 tokensUpdated 3 days ago
    Auto-check passed
  • Biotech Catalyst Radar

    hh-health-AI/healthcare-equity

    A skill your agent uses for a defined biotech trial watchlist, registry-version comparisons, catalyst calendars or changed enrollment, status and completion estimates.

    101 GitHub stars~760 tokensUpdated 3 days ago
    Auto-check passed
  • Biotech Catalyst Radar

    hh-health-AI/healthcare-equity

    A skill your agent uses to monitor a defined biotech trial watchlist, compare registry versions, build a catalyst calendar or explain changed enrollment, status or completion estimates.

    101 GitHub stars~846 tokensUpdated 3 days ago
    Auto-check passed

Questions about Faers Safety Scan

What does Faers Safety Scan do?

This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label…. Faers Safety Scan is an agent skill from hh-health-AI/healthcare-equity. This skill should be used when the user asks about "FAERS", "adverse event signal", "disproportionality", "PRR", "ROR", "safety short", "is there a signal on [drug]", "boxed warning risk", "label change risk", or wants to screen post-market safety reporting for a marketed drug against a comparator.

When should I use Faers Safety Scan?

Faers Safety Scan fits situations like: asks about FAERS; adverse event signal; disproportionality; is there a signal on [drug].

How do I install Faers Safety Scan in Claude Code?

Run `npx skills add hh-health-AI/healthcare-equity --skill faers-safety-scan -a claude-code`. Or copy the skill folder (modules/fda-safety-signals/skills/faers-safety-scan in hh-health-AI/healthcare-equity) into .claude/skills/faers-safety-scan in your project. Claude Code loads it when a task matches its description.

How do I install Faers Safety Scan in Codex?

Run `npx skills add hh-health-AI/healthcare-equity --skill faers-safety-scan -a codex`. Or copy the skill folder (modules/fda-safety-signals/skills/faers-safety-scan in hh-health-AI/healthcare-equity) into .agents/skills/faers-safety-scan in your project. Codex loads it when a task matches its description.

Can I use Faers Safety Scan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hh-health-AI/healthcare-equity --skill faers-safety-scan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/faers-safety-scan, .gemini/skills/faers-safety-scan, .github/skills/faers-safety-scan and .opencode/skills/faers-safety-scan in your project.

What does Faers Safety Scan need to run?

SKILL.md names no scripts, command-line tools or credentials: Faers Safety Scan is instructions for the agent only.

Does Faers Safety Scan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Faers Safety Scan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Faers Safety Scan use?

Faers Safety Scan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Faers Safety Scan use?

About 843 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 718 tokens, read only when the agent opens those files.

What are the alternatives to Faers Safety Scan?

Skills that share tags, products or a category with Faers Safety Scan: Safety Scan (ruvnet/ruflo, 74k stars), Scan (wshobson/agents, 40k stars), Repo Scan (affaan-m/ECC, 276k stars) and Repo Scan (affaan-m/ECC, 276k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Faers Safety Scan?

hh-health-AI (a GitHub user) maintains it in hh-health-AI/healthcare-equity, which has 101 GitHub stars. The repository holds 72 skills in this directory. The repository was last updated on October 8, 2026.

Source: hh-health-AI/healthcare-equity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.