Skip to content

genomoncology/biomcp-release-rehearsal / skills

biomcp

Verified

Search and retrieve biomedical data - genes, variants, clinical trials, diagnostic tests, articles, drugs, diseases, pathways, proteins, adverse events, pharmacogenomics, and phenotype-disease matching. Use for gene function, variant pathogenicity, trials, diagnostics, drug safety, pathway context, disease workups, and literature evidence.

FileKindSize
AUTHORING.mdmarkdown2.5 KB
SKILL.mdskill md16.2 KB
examples/get-gene-BRAF.jsonconfig1.6 KB
examples/get-gene-BRAF.txtmarkdown1.1 KB
examples/get-trial.jsonconfig2.8 KB
examples/get-trial.txtmarkdown1.3 KB
examples/get-variant-rs113488022-all.jsonconfig2.4 KB
examples/get-variant-rs113488022-all.txtmarkdown5.4 KB
examples/search-article.jsonconfig947 B
examples/search-article.txtmarkdown951 B
examples/search-drug.jsonconfig1.5 KB
examples/search-drug.txtmarkdown511 B
jq-examples.mdmarkdown906 B
schemas/article.jsonconfig2.2 KB
schemas/disease.jsonconfig2.0 KB
schemas/drug.jsonconfig2.5 KB
schemas/gene.jsonconfig15.4 KB
schemas/pathway.jsonconfig1.3 KB
schemas/trial.jsonconfig8.1 KB
schemas/variant.jsonconfig4.5 KB
schemas/workflow-ladder.schema.jsonconfig1.1 KB
use-cases/01-treatment-lookup.mdmarkdown568 B
use-cases/02-symptom-phenotype.mdmarkdown853 B
use-cases/03-gene-disease-orientation.mdmarkdown1.0 KB
use-cases/04-article-follow-up.mdmarkdown707 B
use-cases/05-variant-pathogenicity.mdmarkdown1.2 KB
use-cases/06-drug-regulatory.mdmarkdown1.0 KB
use-cases/07-gene-function-localization.mdmarkdown753 B
use-cases/08-mechanism-pathway.mdmarkdown711 B
use-cases/09-trial-recruitment.mdmarkdown756 B
use-cases/10-pharmacogene-cumulative.mdmarkdown754 B
use-cases/11-disease-locus-mapping.mdmarkdown868 B
use-cases/12-cellular-process-regulation.mdmarkdown637 B
use-cases/13-mutation-catalog.mdmarkdown1011 B
use-cases/14-syndrome-disambiguation.mdmarkdown757 B
use-cases/15-negative-evidence.mdmarkdown865 B
use-cases/16-normalize-to-codes.mdmarkdown828 B
use-cases/17-exact-variant-literature.mdmarkdown3.0 KB
use-cases/_TEMPLATE.ladder.jsonconfig749 B
use-cases/_TEMPLATE.mdmarkdown476 B
use-cases/article-follow-up.ladder.jsonconfig771 B
use-cases/mechanism-pathway.ladder.jsonconfig985 B
use-cases/mutation-catalog.ladder.jsonconfig905 B
use-cases/normalize-to-codes.ladder.jsonconfig865 B
use-cases/pharmacogene-cumulative.ladder.jsonconfig993 B
use-cases/treatment-lookup.ladder.jsonconfig836 B
use-cases/trial-recruitment.ladder.jsonconfig996 B
use-cases/variant-pathogenicity.ladder.jsonconfig959 B

use-cases/17-exact-variant-literature.md

View on GitHub
# Pattern: Exact-variant literature retrieval

Use this when you have a complete gene plus protein change and need a compact, evidence-first literature shortlist without making a clinical classification.

```bash
biomcp search variant MSH2 p.L341P --limit 5
biomcp variant articles "MSH2 p.L341P" --limit 5
biomcp batch article 26951660,31433521 --mode compact
biomcp get article 26951660 fulltext
biomcp --json get article 26951660 assets
biomcp article citations 26951660 --limit 5
biomcp article references 26951660 --limit 5
```

For an assembly-aware one-item request, save `[{"request_id":"atm-grch38","gene":"ATM","transcript":"NM_000051.4","coding":"c.1066-6T>G","accession":"NC_000011.10","build":"GRCh38","position":108248927,"ref":"T","alt":"G"}]` as `variants.json`, then run `biomcp --json variant articles --input variants.json`.

Interpretation:
- Resolve the strict identity first; do not treat a search spelling as a normalized result.
- `caller_supplied` means BioMCP accepted the supplied fields as one caller assertion; it validated syntax but did not establish cross-coordinate equivalence.
- `provider_confirmed` means MyVariant uniquely confirmed the request; otherwise inspect `provider_validation` for `not_found`, `indeterminate`, `contradictory`, or `unavailable` and its nullable matched alias or contradictory field.
- RefSeq exact work starts with caller-present transcript/coding, gene/coding, and genomic aliases. When separately supplied versioned RefSeq transcript/coding and genomic/build identities agree through CAR, `canonical_equivalence` records additive CAid evidence; confirmed CAR aliases may fill unused retrieval slots without altering resolution, with no liftover or article-evidence claim.
- Use the union shortlist, compare summaries in one batch, request full text/assets only for selected papers, and expand citations or references only when needed. `provenance.query_aliases` is a retrieval input, not evidence that a paper contains the alias; inspect `--debug-plan` for strict and discovery requests. For a conservative captured-evidence pass, run `biomcp --json variant articles "MSH2 p.L341P" --verify-identity --confirmed-only`. Verification occurs before ranking and pagination, and confirms from either a returned-PMID typed PubTator Gene/Variant linkage whose exact HGVS and CorrespondingGene/NCBI Gene-ID facts agree, or an optional bounded ClinGen LDH annotation binding an applicable CAid, requested gene, known PMCID, and exact text/table selector. LDH observes only retrieved candidates: absent coverage is not negative evidence. `identity.observations` records provider, locator, linked gene, observed alias, typed `provider_linkage`, and captured-content hash; an absent or incomplete observation is not confirmation. The debug artifact hashes are versioned clinically relevant response/content audit facts, never retrieval-cache keys or query aliases, and verification does not fetch supplements automatically. Incomplete verification remains truncated with no total; frozen fixtures are release proof, while live probes are diagnostics.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall