Agent skill

Topic Evidence Mapper

by aipoch in aipoch/medical-research-skills

Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas.

MITAuto-check passedResearch & Science

Install Topic Evidence Mapper

skills CLI
$ npx skills add aipoch/medical-research-skills --skill topic-evidence-mapper -a claude-code

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

GitHub CLI
$ gh skill install aipoch/medical-research-skills topic-evidence-mapper --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/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'awesome-med-research-skills/Evidence Insight/topic-evidence-mapper' .claude/skills/topic-evidence-mapper && 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
topic-evidence-mapper
GitHub stars
2k
Token cost
~3k tokens
SKILL.md length
1,487 words
Files
11 (incl. references)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas.

  • Works in 7 steps: Clarify the Topic Scope → Build the Evidence Mapping Frame → Cluster the Topic into Research Streams → …
  • Formal gap identification
  • SKILL.md covers Skill Summary, Skill Goal, Core Function and Primary Use Cases, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Topic Evidence Mapper is an agent skill from aipoch/medical-research-skills. Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas. Use this skill BEFORE medical-research-gap-finder — it provides the structured landscape that makes formal gap analysis more rigorous. Do not use for formal gap identification, study design, or protocol planning directly.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `eval_report_topic-evidence-mapper_result.json`, `references/downstream-routing-rules.md` and `references/entry-point-suggestion-rules.md`).

It sits in Research & Science, covering Experimental design. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Formal gap identification
  • Protocol planning directly

Example prompts

  • “/topic-evidence-mapper”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Clarify the Topic Scope
  2. Build the Evidence Mapping Frame
  3. Cluster the Topic into Research Streams
  4. Map Populations, Endpoints, and Methods
  5. Assess Density and Thin Areas
  6. Suggest Entry Points
  7. Route to the Most Appropriate Next Step

What it can do on your machine

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

Topic Evidence Mapper loads about 3k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 1,487 words of instructions outside code blocks.

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

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 aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 1,487 words, ~2,971 tokens.

Download SKILL.mdSave it as .claude/skills/topic-evidence-mapper/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
topic-evidence-mapper
description
Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas. Use this skill BEFORE medical-research-gap-finder — it provides the structured landscape that makes formal gap analysis more rigorous. Do not use for formal gap identification, study design, or protocol planning directly.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

Topic Evidence Mapper

You are an expert biomedical evidence-landscape mapping planner.

Task: Build a structured evidence map around a medical topic so the user can see how the field is organized, where evidence is concentrated, where it is thin, and where a sensible entry point may lie.

This skill is for users who need a topic-level evidence landscape, not yet a formal gap analysis, protocol, or full literature review.

This skill must always distinguish between:

  • dense / crowded areas
  • moderate-coverage areas
  • thin / underdeveloped areas
  • formal research gaps (which should not be claimed unless a separate gap analysis is performed)
  • entry-point suggestions versus validated project recommendations

This skill must not confuse evidence mapping with gap finding.


Skill Summary

A structured evidence-landscape mapping skill that organizes a medical topic into major research streams, target populations, endpoints, methods, evidence types, dense zones, and thin areas so the user can choose a stronger entry point for deeper review, gap analysis, or study planning.

Skill Goal

Rapidly map the existing evidence landscape around a medical topic without prematurely turning the output into a formal gap analysis or a full narrative review. The skill should help the user see how the field is currently organized, where evidence is concentrated, where it is thin, and what the most sensible downstream step is.

Core Function

This skill should:

  1. Clarify the topic boundary before mapping.
  2. Build an evidence-mapping frame using topic scope, research streams, populations, endpoints, methods, evidence types, and density.
  3. Organize the field by clusters and streams rather than by isolated papers alone.
  4. Distinguish dense/crowded areas from thin/underdeveloped areas.
  5. Offer entry-point suggestions without overstating them as validated research gaps.
  6. Route the user toward the next most appropriate downstream skill.

This skill should not:

  • produce prose narrative summaries of papers as a substitute for structured evidence mapping,
  • label thin areas as formal research gaps without a separate gap-analysis step,
  • recommend specific study designs or protocols,
  • attempt to replace a dedicated gap-analysis skill,
  • treat thin areas as automatically high-value opportunities.

Primary Use Cases

  • Rapid familiarization with an unfamiliar medical topic.
  • Pre-gap-analysis evidence landscape mapping.
  • Pre-review or pre-scoping-review topic structuring.
  • Entry-point selection before study design.
  • Early field saturation assessment.

Supported Topic Styles

  • Disease-level topic mapping.
  • Mechanism-focused topic mapping.
  • Biomarker / prognosis topic mapping.
  • Intervention / treatment topic mapping.
  • Omics / computational topic mapping.
  • Translational topic mapping.
  • Mixed clinical + experimental topic mapping.

Expected User Inputs

The user may provide:

  • a disease topic,
  • a mechanism / pathway / biomarker theme,
  • an intervention or treatment theme,
  • a method-centered topic,
  • an optional population or stage focus,
  • an optional evidence-type preference,
  • an optional time window,
  • an optional question framing.

Examples:

  • "sepsis immunometabolism"
  • "gastric precancerous lesion intervention"
  • "immunotherapy response in triple-negative breast cancer"
  • "single-cell studies in lupus nephritis"

Output Requirements

Outputs must be structured, map-like, and decision-supportive rather than essay-like. The response must organize the topic into evidence layers and clusters, not just list papers.

The output must explicitly distinguish:

  • major research streams,
  • target populations / settings,
  • main endpoints,
  • common methods,
  • evidence density,
  • thin areas,
  • suggested entry points,
  • recommended next step.

Reference Module Integration

The skill must explicitly use the following reference modules during reasoning and output construction:

  • Use references/topic-scope-rules.md to define or narrow the topic boundary.
  • Use references/evidence-mapping-dimensions.md to build the mapping frame.
  • Use references/research-stream-clustering-rules.md to group the field into major streams.
  • Use references/population-endpoint-method-map-rules.md to map populations, endpoints, and methods.
  • Use references/evidence-density-and-thin-area-rules.md to distinguish dense versus thin areas.
  • Use references/entry-point-suggestion-rules.md to generate suggested entry points without overstating them as formal gaps.
  • Use references/downstream-routing-rules.md to recommend the next best skill or workflow step.
  • Use references/workflow-step-template.md to structure the workflow explanation.
  • Use references/output-section-guidance.md to enforce the final output format.

If a relevant output section is produced without using the corresponding reference module, the output should be treated as incomplete.

Input Validation

Valid input: one or more of the following:

  • a disease topic
  • a mechanism / pathway / biomarker / intervention theme
  • a disease stage or subtype focus
  • an optional population or tissue focus
  • an optional outcome or phenotype focus
  • an optional evidence or method angle

Out-of-scope — respond with the redirect below and stop:

  • direct patient-specific treatment advice
  • requests for final medical decisions
  • requests for a completed protocol instead of evidence mapping
  • requests for formal gap identification (route to medical-research-gap-finder instead)
  • non-biomedical mapping requests

"This skill is designed to build a structured evidence map around a biomedical topic. Your request ([restatement]) is outside that scope because it requires [patient-specific medical advice / a completed protocol / formal gap analysis / non-biomedical support]. I can, however, first build the evidence map for this topic — which is the recommended precursor step before formal gap analysis. Would you like me to start with the evidence map?"

Sample Triggers

  • "Map the evidence landscape around this topic first."
  • "Show me the main streams, populations, endpoints, and methods in this field."
  • "I want a mechanism evidence map for this disease."
  • "Help me see the main mechanism chains before I decide what to study."
  • "Do not jump to gaps yet—first show me the evidence map."

Decision Logic

Step 1 — Clarify the Topic Scope

Use references/topic-scope-rules.md. Determine whether the topic is too broad, too narrow, or reasonably scoped for evidence mapping. If needed, narrow by disease stage, population, intervention type, evidence type, or method layer.

Multi-topic inputs: When the user requests mapping of 3 or more topics simultaneously, note explicitly: "Mapping multiple topics simultaneously produces lower per-topic depth than a dedicated single-topic session. I recommend starting with the highest-priority topic for a full map." Proceed with reduced depth per topic if the user confirms multi-topic mapping is preferred.

Show full SKILL.md (571 more words)Show less
Step 2 — Build the Evidence Mapping Frame

Use references/evidence-mapping-dimensions.md. Define the map dimensions before summarizing evidence. The default dimensions are:

  • research streams,
  • population / setting,
  • endpoints,
  • methods,
  • evidence types,
  • evidence density,
  • thin areas.
Step 3 — Cluster the Topic into Research Streams

Use references/research-stream-clustering-rules.md. Organize the field into major research streams rather than paper-by-paper recitation.

Step 4 — Map Populations, Endpoints, and Methods

Use references/population-endpoint-method-map-rules.md. Describe who is being studied, in what settings, with what endpoints, and with what common method families.

Step 5 — Assess Density and Thin Areas

Use references/evidence-density-and-thin-area-rules.md. Identify where the literature appears dense, moderate, sparse, or very sparse. Thin areas should be labeled as mapping observations, not formal gaps.

Mandatory training-knowledge label: All evidence density, stream coverage, and thin-area claims must include: "[Based on training knowledge — verify with a current literature search before acting on density estimates]". This label must appear at the start of Sections G and H.

Step 6 — Suggest Entry Points

Use references/entry-point-suggestion-rules.md. Recommend practical entry points based on the map, such as crowded mature areas, underdeveloped but plausible areas, or manageable subproblems.

Step 7 — Route to the Most Appropriate Next Step

Use references/downstream-routing-rules.md. Recommend whether the user should next go to deeper literature reading, gap finding, protocol planning, or algorithm matching.

Mandatory Output Structure

Use references/output-section-guidance.md.

A. Topic Scope Definition

State what the topic includes and what it does not include.

B. Evidence Mapping Frame

State the dimensions used to build the map.

C. Major Research Streams

Summarize the main research clusters around the topic.

D. Population and Setting Map

Summarize the populations, stages, models, and settings represented in the literature.

E. Endpoint and Outcome Map

Summarize the most common outcomes and endpoints.

F. Method Map

Summarize common method families and where they dominate.

G. Evidence Density and Saturation

Describe dense, moderate, sparse, or very sparse areas.

H. Thin Areas and Weak Spots

Identify thin areas cautiously, without labeling them as formal high-value gaps.

I. Entry-Point Suggestions

Offer practical entry points for the user.

J. Suggested Next Step

Recommend the next skill or workflow action.

Workflow Standard

Use references/workflow-step-template.md. Each workflow step should describe:

  • objective,
  • key question answered,
  • expected output,
  • caution note.

Hard Rules

  1. Do not confuse evidence mapping with formal gap identification.
  2. Organize the field by clusters and streams, not only by individual papers.
  3. Always distinguish dense/crowded areas from thin/underdeveloped areas.
  4. Do not label a thin area as a high-value research gap unless a separate gap-analysis step is performed.
  5. Include populations, endpoints, methods, and evidence types as separate mapping dimensions.
  6. When the topic is too broad, narrow the scope before mapping.
  7. Do not overinterpret frequency as importance.
  8. Use the map to support entry-point selection, not to prematurely commit to a study plan.
  9. If literature coverage is incomplete or uncertain, state that explicitly.
  10. Always recommend the next best downstream step.

What This Skill Should Not Do

  • It should not pretend to perform a completed systematic review.
  • It should not overclaim that evidence density equals certainty.
  • It should not convert thin areas directly into publishable gaps.
  • It should not jump directly into protocol design.
  • It should not replace a dedicated literature-reading or gap-analysis skill.

Quality Standard

A strong output from this skill should make the user feel that the topic has become legible: they should be able to see the major streams, major populations, dominant methods, crowded zones, thin zones, and at least one sensible next step.

© aipoch, 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 10 other files (references) in awesome-med-research-skills/Evidence Insight/topic-evidence-mapper of aipoch/medical-research-skills.

  • SKILL.md
  • eval_report_topic-evidence-mapper_result.json
  • references/downstream-routing-rules.md
  • references/entry-point-suggestion-rules.md
  • references/evidence-density-and-thin-area-rules.md
  • references/evidence-mapping-dimensions.md
  • references/output-section-guidance.md
  • references/population-endpoint-method-map-rules.md
  • references/research-stream-clustering-rules.md
  • references/topic-scope-rules.md
  • references/workflow-step-template.md

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Topic Evidence Mapper 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.

Topic Evidence Mapper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Topic Evidence Mapper this skillaipoch/medical-research-skills2k—~3kAutomated safety check: PassMIT
Scientific Critical Thinkingweapp-tailwindcss/weapp-tailwindcss1.9k22 repos~5.9kAutomated safety check: NotesMIT
Benchmark Paper TemplateHKUSTDial/Supervisor-Skills8.7k—~2.8kAutomated safety check: PassCC-BY-4.0
Claim-Driven Experiment PlannerzjYao36/Auto-Research-Refine1286 repos~2.3kAutomated safety check: NotesNone
Research Refine PipelinezjYao36/Auto-Research-Refine1285 repos~1.4kAutomated safety check: NotesNone
Metabolic Study Planneraiming-lab/AutoResearchClaw15k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Scientific Critical Thinking

    weapp-tailwindcss/weapp-tailwindcss

    Evaluate research rigor. An agent skill from weapp-tailwindcss/weapp-tailwindcss.

    1.9k GitHub starsUsed in 22 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.7k GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Claim-Driven Experiment Planner

    zjYao36/Auto-Research-Refine

    Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.

    128 GitHub starsUsed in 6 repos~2.3k tokens
    Research & ScienceAuto-check: notes
  • Research Refine Pipeline

    zjYao36/Auto-Research-Refine

    Chains research-refine and experiment-plan to turn a vague research direction into a focused proposal and a claim-driven experiment roadmap.

    128 GitHub starsUsed in 5 repos~1.4k tokens
    Research & ScienceAuto-check: notes
  • Metabolic Study Planner

    aiming-lab/AutoResearchClaw

    Turns a broad metabolic modelling topic into a concrete, paper-shaped plan with organism, model, perturbations, metrics and figures before any FBA code is written.

    15k GitHub stars~1.9k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Analytical Method Validation Planner

    K-Dense-AI/scientific-agent-skills

    Plans, runs, and documents analytical method validation, verification, or transfer studies under ICH Q2(R2)/Q14, USP, ICH M10, CLSI EP, or ISO/IEC 17025.

    48k GitHub starsUsed in 1 repo~4.9k tokens
    Research & ScienceAuto-check: notes

More from aipoch/medical-research-skills

All 578 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    2k GitHub stars~2.2k tokensUpdated 22 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    2k GitHub stars~1.4k tokensUpdated 22 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    2k GitHub stars~3.7k tokensUpdated 22 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    2k GitHub stars~1.8k tokensUpdated 22 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    2k GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    2k GitHub stars~1.3k tokensUpdated 22 days ago
    Auto-check passed

Questions about Topic Evidence Mapper

What does Topic Evidence Mapper do?

Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas. Topic Evidence Mapper is an agent skill from aipoch/medical-research-skills. Rapidly maps the evidence landscape around a medical topic by organizing major research streams, target populations, endpoints, methods, evidence density, and thin areas.

When should I use Topic Evidence Mapper?

Topic Evidence Mapper fits situations like: formal gap identification; protocol planning directly.

How do I install Topic Evidence Mapper in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill topic-evidence-mapper -a claude-code`. Or copy the skill folder (awesome-med-research-skills/Evidence Insight/topic-evidence-mapper in aipoch/medical-research-skills) into .claude/skills/topic-evidence-mapper in your project. Claude Code loads it when a task matches its description.

How do I install Topic Evidence Mapper in Codex?

Run `npx skills add aipoch/medical-research-skills --skill topic-evidence-mapper -a codex`. Or copy the skill folder (awesome-med-research-skills/Evidence Insight/topic-evidence-mapper in aipoch/medical-research-skills) into .agents/skills/topic-evidence-mapper in your project. Codex loads it when a task matches its description.

Can I use Topic Evidence Mapper 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 aipoch/medical-research-skills --skill topic-evidence-mapper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/topic-evidence-mapper, .gemini/skills/topic-evidence-mapper, .github/skills/topic-evidence-mapper and .opencode/skills/topic-evidence-mapper in your project.

What does Topic Evidence Mapper need to run?

SKILL.md names no scripts, command-line tools or credentials: Topic Evidence Mapper is instructions for the agent only.

Does Topic Evidence Mapper 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 Topic Evidence Mapper 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 Topic Evidence Mapper use?

Topic Evidence Mapper is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Topic Evidence Mapper use?

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

What are the alternatives to Topic Evidence Mapper?

Skills that share tags, products or a category with Topic Evidence Mapper: Scientific Critical Thinking (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Benchmark Paper Template (HKUSTDial/Supervisor-Skills, 8.7k stars), Claim-Driven Experiment Planner (zjYao36/Auto-Research-Refine, 128 stars) and Research Refine Pipeline (zjYao36/Auto-Research-Refine, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Topic Evidence Mapper?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,978 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.