Agent skill

Disease Research

by lamm-mit in lamm-mit/scienceclaw

Generate comprehensive disease research reports using 100+ ToolUniverse tools.

Apache-2.0Auto-check passedResearch & Science

Install Disease Research

skills CLI
$ npx skills add lamm-mit/scienceclaw --skill disease-research -a claude-code

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

GitHub CLI
$ gh skill install lamm-mit/scienceclaw disease-research --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/lamm-mit/scienceclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/disease-research .claude/skills/disease-research && 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
disease-research
GitHub stars
244
Token cost
~946 tokens
SKILL.md length
370 words
Files
4 (incl. scripts, references)
Skills in repo
86
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate comprehensive disease research reports using 100+ ToolUniverse tools.

  • Works in 4 steps: Create report file — Initialize… → Research each dimension — Query all… → Update report progressively — Write… → …
  • Users ask about diseases
  • SKILL.md covers When to Use, Core Workflow: Report-First…, Citation Requirements and Detailed References, plus 1 more section
  • Runs Python scripts from its folder

What it does

Disease Research is an agent skill from lamm-mit/scienceclaw. Generate comprehensive disease research reports using 100+ ToolUniverse tools. The agent creates a detailed markdown report file and progressively updates it with findings from 10 research dimensions, with full source citations. Use when users ask about diseases, syndromes, or need systematic disease analysis.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/tool-reference.md` and `scripts/run.py`).

It sits in Research & Science, covering Deep research and Citation management. The licence is Apache-2.0.

When your agent uses it

  • Users ask about diseases
  • Need systematic disease analysis

Example prompts

  • “/disease-research”

Requirements

  • Python 3

Workflow steps

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

  1. Create report file — Initialize {disease_name}_research_report.md with the full report template
  2. Research each dimension — Query all relevant ToolUniverse tools per dimension
  3. Update report progressively — Write findings to the file after completing each dimension
  4. Include citations — Every fact must reference the source tool that provided it

What it can do on your machine

Read from SKILL.md and the folder at commit ab9aba1. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    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

Disease Research loads about 946 tokens when it runs, and up to ~5.2k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 370 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from lamm-mit/scienceclaw at commit ab9aba1, republished under its Apache-2.0 licence (© lamm-mit). 370 words, ~946 tokens.

Download SKILL.mdSave it as .claude/skills/disease-research/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
disease-research
description
Generate comprehensive disease research reports using 100+ ToolUniverse tools. The agent creates a detailed markdown report file and progressively updates it with findings from 10 research dimensions, with full source citations. Use when users ask about diseases, syndromes, or need systematic disease analysis.
metadata.source
https://github.com/mims-harvard/ToolUniverse/tree/main/skills/tooluniverse-disease-research

ToolUniverse Disease Research

The agent generates a comprehensive, citation-backed disease research report by creating a markdown file and progressively updating it across 10 research dimensions.

IMPORTANT: The agent should always use English disease names and search terms in tool calls, even if the user writes in another language. Original-language terms should only be tried as a fallback if English returns no results. The agent responds in the user's language.

When to Use

This skill applies when the user:

  • Asks about any disease, syndrome, or medical condition
  • Needs comprehensive disease intelligence
  • Wants a detailed research report with citations
  • Asks "what do we know about [disease]?"

Core Workflow: Report-First Approach

The agent should not show the search process to the user. Instead it follows this pattern:

  1. Create report file — Initialize {disease_name}_research_report.md with the full report template
  2. Research each dimension — Query all relevant ToolUniverse tools per dimension
  3. Update report progressively — Write findings to the file after completing each dimension
  4. Include citations — Every fact must reference the source tool that provided it
Show full SKILL.md (198 more words)Show less
The 10 Research Dimensions
#DimensionKey Focus
1Disease Identity & ClassificationEFO, ICD-10, UMLS, SNOMED identifiers; synonyms; disease hierarchy
2Clinical PresentationHPO phenotypes; symptoms and signs; diagnostic criteria
3Genetic & Molecular BasisAssociated genes; GWAS associations; ClinVar pathogenic variants
4Treatment LandscapeApproved drugs; clinical trials; treatment guidelines
5Biological Pathways & MechanismsReactome pathways; PPI networks; tissue expression
6Epidemiology & Risk FactorsPrevalence; risk factors; GWAS studies
7Literature & Research ActivityPublication trends; key papers; research institutions
8Similar Diseases & ComorbiditiesDisease similarity scores; shared genetic basis
9Cancer-Specific InformationCIViC variants; molecular profiles; targeted therapies (if applicable)
10Drug Safety & Adverse EventsDrug warnings; trial adverse events; FAERS data
Example
User: "Research Parkinson's disease"

Agent actions (internal, not shown to user):
1. Create "parkinsons_disease_research_report.md" with template
2. Research DIM 1 → Update Identity section
3. Research DIM 2 → Update Clinical section
4. ... continue for all 10 dimensions
5. Present final report to user

Citation Requirements

Every piece of data in the report must include its source tool. The agent should use source columns in tables, [Source: tool_name] annotations in lists, and parenthetical (Source: tool_name, query: ...) references in prose. A complete tool usage log belongs in the References section at the end of the report.

Detailed References

For the full report template, complete tool listings per dimension, implementation examples, citation format guide, and quality checklist, see references/tool-reference.md.

Additional Resources

See TOOLS_REFERENCE.md for complete tool documentation. See EXAMPLES.md for sample reports.

© lamm-mit, Apache-2.0. 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 3 other files (scripts, references) in skills/disease-research of lamm-mit/scienceclaw.

  • SKILL.md
  • references/tool-reference.md
  • scripts/__pycache__/run.cpython-313.pyc
  • scripts/run.py

Open the folder on GitHubat commit ab9aba1

Compare with similar skills

Disease Research 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.

Disease Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Disease Research this skilllamm-mit/scienceclaw244—~946Automated safety check: PassApache-2.0
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Deep Research Literature SurveyHKUSTDial/Supervisor-Skills8.7k—~2.4kAutomated safety check: PassCC-BY-NC-SA-4.0
Parallel WebLeonChaoX/qinyan-academic-skills9431 repos~2.9kAutomated safety check: NotesMIT
Live Researchbrightdata/skills264—~1.8kAutomated safety check: PassMIT

Similar skills

  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated today
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 6 days ago
    Research & ScienceAuto-check passed
  • Deep Research Literature Survey

    HKUSTDial/Supervisor-Skills

    Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

    8.7k GitHub stars~2.4k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Parallel Web

    LeonChaoX/qinyan-academic-skills

    Search the web, extract URL content, and run deep research using the Parallel Chat API and Extract API.

    943 GitHub starsUsed in 1 repo~2.9k tokens
    Research & ScienceAuto-check: notes
  • Live Research

    brightdata/skills

    Produce a deep, multi-source, cited research brief on a topic from live web data using Bright Data's Discover API (intent-ranked web search + parsed page content).

    264 GitHub stars~1.8k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Deep Research Methodology

    RightNow-AI/openfang

    Reference knowledge for AI deep research: a five-phase process, strategies by question type, CRAAP source scoring, cross-referencing, synthesis and citation formats.

    18k GitHub stars~2.6k tokensUpdated 3 mo ago
    Research & ScienceAuto-check passed

More from lamm-mit/scienceclaw

All 86 skills in this repo
  • Fred Economic Data

    lamm-mit/scienceclaw

    Query FRED (Federal Reserve Economic Data) API for 800,000+ economic time series from 100+ sources.

    244 GitHub starsUsed in 4 repos~3k tokens
    Auto-check passed
  • Drug Research

    lamm-mit/scienceclaw

    Generates comprehensive drug research reports with compound disambiguation, evidence grading, and mandatory completeness sections.

    244 GitHub starsUsed in 3 repos~1.7k tokens
    Auto-check passed
  • Imaging Data Commons

    lamm-mit/scienceclaw

    Query and download public cancer imaging data from NCI Imaging Data Commons using idc-index.

    244 GitHub starsUsed in 5 repos~11k tokens
    Auto-check passed
  • Rowan

    lamm-mit/scienceclaw

    Cloud-based quantum chemistry platform with Python API. An agent skill from lamm-mit/scienceclaw.

    244 GitHub starsUsed in 4 repos~3.1k tokens
    Auto-check: warnings
  • Infographics

    lamm-mit/scienceclaw

    Create professional infographics using Nano Banana Pro AI with smart iterative refinement.

    244 GitHub starsUsed in 6 repos~4.4k tokens
    Auto-check: notes
  • Biopython

    lamm-mit/scienceclaw

    Computational molecular biology library (sequence I/O, alignment, phylogenetics).

    244 GitHub stars~3.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Disease Research

What does Disease Research do?

Generate comprehensive disease research reports using 100+ ToolUniverse tools. Disease Research is an agent skill from lamm-mit/scienceclaw. Generate comprehensive disease research reports using 100+ ToolUniverse tools.

When should I use Disease Research?

Disease Research fits situations like: users ask about diseases; need systematic disease analysis.

How do I install Disease Research in Claude Code?

Run `npx skills add lamm-mit/scienceclaw --skill disease-research -a claude-code`. Or copy the skill folder (skills/disease-research in lamm-mit/scienceclaw) into .claude/skills/disease-research in your project. Claude Code loads it when a task matches its description.

How do I install Disease Research in Codex?

Run `npx skills add lamm-mit/scienceclaw --skill disease-research -a codex`. Or copy the skill folder (skills/disease-research in lamm-mit/scienceclaw) into .agents/skills/disease-research in your project. Codex loads it when a task matches its description.

Can I use Disease Research 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 lamm-mit/scienceclaw --skill disease-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/disease-research, .gemini/skills/disease-research, .github/skills/disease-research and .opencode/skills/disease-research in your project.

What does Disease Research need to run?

Going by SKILL.md and its folder, Disease Research needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Disease Research 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 Disease Research 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Disease Research use?

Disease Research is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Disease Research use?

About 946 tokens (SKILL.md is roughly 3.8k 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 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Disease Research?

Skills that share tags, products or a category with Disease Research: Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars), Deep Research Literature Survey (HKUSTDial/Supervisor-Skills, 8.7k stars) and Parallel Web (LeonChaoX/qinyan-academic-skills, 943 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Disease Research?

lamm-mit (a GitHub user) maintains it in lamm-mit/scienceclaw, which has 244 GitHub stars. The repository holds 86 skills in this directory. The repository was last updated on August 21, 2026.

Source: lamm-mit/scienceclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.