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

schemas/gene.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "BioMCP Gene",
  "type": "object",
  "required": ["symbol", "name"],
  "properties": {
    "symbol": { "type": "string" },
    "name": { "type": "string" },
    "entrez_id": { "type": ["string", "null"] },
    "ensembl_id": { "type": ["string", "null"] },
    "location": { "type": ["string", "null"] },
    "genomic_coordinates": {
      "type": ["object", "null"],
      "properties": {
        "coordinate": { "type": "string" },
        "genome_build": { "type": "string" },
        "source": { "type": "string" },
        "provenance": { "type": "string" }
      },
      "required": ["coordinate", "genome_build", "source"],
      "additionalProperties": false
    },
    "omim_id": { "type": ["string", "null"] },
    "uniprot_id": { "type": ["string", "null"] },
    "summary": { "type": ["string", "null"] },
    "gene_type": { "type": ["string", "null"] },
    "aliases": {
      "type": ["array", "null"],
      "items": { "type": "string" }
    },
    "clinical_diseases": {
      "type": ["array", "null"],
      "items": { "type": "string" }
    },
    "clinical_drugs": {
      "type": ["array", "null"],
      "items": { "type": "string" }
    },
    "clingen": {
      "type": "object",
      "properties": {
        "validity": {
          "type": "array",
          "maxItems": 5,
          "items": {
            "type": "object",
            "properties": {
              "disease": { "type": "string" },
              "classification": { "type": "string" },
              "review_date": { "type": "string" },
              "moi": { "type": "string" }
            },
            "required": ["disease", "classification"],
            "additionalProperties": false
          }
        },
        "haploinsufficiency": { "type": "string" },
        "triplosensitivity": { "type": "string" },
        "validity_status": { "$ref": "#/$defs/validityStatus" },
        "dosage_status": { "$ref": "#/$defs/dosageStatus" }
      },
      "required": ["validity_status", "dosage_status"],
      "additionalProperties": false
    },
    "gencc": {
      "type": "object",
      "properties": {
        "assertions": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "type": "object",
            "properties": {
              "id": { "type": "string", "pattern": "^SGC-[1-9][0-9]*\\.[1-9][0-9]*$" },
              "sgc_id": { "type": "string", "pattern": "^SGC-[1-9][0-9]*$" },
              "version": { "type": "integer", "minimum": 1, "maximum": 4294967295 },
              "gene": { "$ref": "#/$defs/genccGeneTerm" },
              "disease": { "$ref": "#/$defs/genccDiseaseTerm" },
              "classification": { "$ref": "#/$defs/genccClassification" },
              "mode_of_inheritance": { "$ref": "#/$defs/genccInheritanceTerm" },
              "submitter": { "$ref": "#/$defs/genccSubmitterTerm" },
              "evaluated_date": { "$ref": "#/$defs/genccDate" },
              "submitted_date": { "$ref": "#/$defs/genccDate" },
              "source_record_url": { "type": "string", "pattern": "^https://thegencc\\.org/submissions/SGC-[1-9][0-9]*\\.[1-9][0-9]*$" },
              "public_report_url": { "$ref": "#/$defs/genccUrl" },
              "assertion_criteria_url": { "$ref": "#/$defs/genccUrl" },
              "publications": {
                "type": "array",
                "maxItems": 128,
                "items": {
                  "type": "object",
                  "properties": {
                    "pmid": { "type": "string", "pattern": "^[1-9][0-9]{0,19}$" },
                    "url": { "type": "string", "pattern": "^https://pubmed\\.ncbi\\.nlm\\.nih\\.gov/[1-9][0-9]{0,19}/$" }
                  },
                  "required": ["pmid", "url"],
                  "additionalProperties": false
                }
              }
            },
            "required": ["id", "sgc_id", "version", "gene", "disease", "classification", "mode_of_inheritance", "submitter", "evaluated_date", "submitted_date", "source_record_url", "public_report_url", "assertion_criteria_url", "publications"],
            "additionalProperties": false
          }
        },
        "total_matching_assertions": { "type": "integer", "minimum": 0 },
        "truncated": { "type": "boolean" },
        "status": { "$ref": "#/$defs/genccStatus" }
      },
      "required": ["assertions", "total_matching_assertions", "truncated", "status"],
      "additionalProperties": false
    },
    "_meta": {
      "type": ["object", "null"],
      "properties": {
        "evidence_urls": {
          "type": ["array", "null"],
          "items": {
            "type": "object",
            "properties": {
              "label": { "type": "string" },
              "url": { "type": "string" }
            },
            "required": ["label", "url"],
            "additionalProperties": true
          }
        },
        "next_commands": {
          "type": ["array", "null"],
          "items": { "type": "string" }
        },
        "workflow": { "type": ["string", "null"] },
        "workflow_rationale": { "type": ["string", "null"] },
        "workflow_playbook": { "type": ["string", "null"] }
      },
      "additionalProperties": true
    }
  },
  "$defs": {
    "genccLabel": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[^\\x00-\\x1F\\x7F]*\\S[^\\x00-\\x1F\\x7F]*$" },
    "genccGeneTerm": {
      "type": "object",
      "properties": {
        "id": { "type": "string", "pattern": "^HGNC:[1-9][0-9]*$" },
        "label": { "$ref": "#/$defs/genccLabel" }
      },
      "required": ["id", "label"],
      "additionalProperties": false
    },
    "genccDiseaseTerm": {
      "type": "object",
      "properties": { "id": { "type": "string", "pattern": "^MONDO:[0-9]{7}$" }, "label": { "$ref": "#/$defs/genccLabel" } },
      "required": ["id", "label"], "additionalProperties": false
    },
    "genccInheritanceTerm": {
      "type": "object",
      "properties": { "id": { "type": "string", "pattern": "^HP:[0-9]{7}$" }, "label": { "$ref": "#/$defs/genccLabel" } },
      "required": ["id", "label"], "additionalProperties": false
    },
    "genccSubmitterTerm": {
      "type": "object",
      "properties": { "id": { "type": "string", "pattern": "^GENCC:[0-9]{6}$" }, "label": { "$ref": "#/$defs/genccLabel" } },
      "required": ["id", "label"], "additionalProperties": false
    },
    "genccClassification": {
      "oneOf": [
        { "$ref": "#/$defs/genccDefinitive" }, { "$ref": "#/$defs/genccStrong" },
        { "$ref": "#/$defs/genccModerate" }, { "$ref": "#/$defs/genccLimited" },
        { "$ref": "#/$defs/genccDisputed" }, { "$ref": "#/$defs/genccRefuted" },
        { "$ref": "#/$defs/genccAnimal" }, { "$ref": "#/$defs/genccNoRelationship" },
        { "$ref": "#/$defs/genccSupportive" }
      ]
    },
    "genccDefinitive": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100001" }, "label": { "const": "Definitive" }, "code": { "const": "definitive" } } },
    "genccStrong": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100002" }, "label": { "const": "Strong" }, "code": { "const": "strong" } } },
    "genccModerate": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100003" }, "label": { "const": "Moderate" }, "code": { "const": "moderate" } } },
    "genccLimited": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100004" }, "label": { "const": "Limited" }, "code": { "const": "limited" } } },
    "genccDisputed": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100005" }, "label": { "const": "Disputed Evidence" }, "code": { "const": "disputed_evidence" } } },
    "genccRefuted": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100006" }, "label": { "const": "Refuted Evidence" }, "code": { "const": "refuted_evidence" } } },
    "genccAnimal": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100007" }, "label": { "const": "Animal Model Only" }, "code": { "const": "animal_model_only" } } },
    "genccNoRelationship": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100008" }, "label": { "const": "No Known Disease Relationship" }, "code": { "const": "no_known_disease_relationship" } } },
    "genccSupportive": { "$ref": "#/$defs/genccClassificationBase", "properties": { "id": { "const": "GENCC:100009" }, "label": { "const": "Supportive" }, "code": { "const": "supportive" } } },
    "genccClassificationBase": {
      "type": "object", "required": ["id", "label", "code"], "additionalProperties": false,
      "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "code": { "type": "string" } }
    },
    "genccDate": { "oneOf": [{ "type": "null" }, { "type": "string", "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" }] },
    "genccUrl": { "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https?://[^\\s]+$" }] },
    "genccStatus": {
      "type": "object",
      "properties": {
        "freshness": { "enum": ["fresh", "stale", "unavailable"] },
        "result": { "enum": ["data", "empty", "unknown"] },
        "operation": { "enum": ["local_query", "initial_download", "conditional_refresh", "retry_suppressed", "refresh_deferred", "identity_match"] },
        "checked_at": { "$ref": "#/$defs/genccTimestamp" },
        "retrieved_at": { "$ref": "#/$defs/genccTimestamp" },
        "attempted_at": { "$ref": "#/$defs/genccTimestamp" },
        "etag": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^(W/)?\\\"[^\\\"]*\\\"$" }] },
        "last_modified": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), [0-9]{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{4} [0-9]{2}:[0-9]{2}:[0-9]{2} GMT$" }] },
        "upstream_version": { "type": "null" },
        "message": { "enum": [null, "GenCC refresh failed; results come from the last validated dataset.", "GenCC refresh is still in progress; results come from the last validated dataset.", "GenCC data is unavailable; no GenCC absence can be concluded.", "GenCC refresh is still in progress; no GenCC absence can be concluded.", "GenCC gene identity is inconclusive; no GenCC absence can be concluded."] }
      },
      "required": ["freshness", "result", "operation", "checked_at", "retrieved_at", "attempted_at", "etag", "last_modified", "upstream_version", "message"],
      "additionalProperties": false
    },
    "genccTimestamp": { "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$" }] },
    "validityStatus": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["data", "empty"] },
            "op": { "const": "gene_validity_download" }
          },
          "required": ["status", "op"],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "const": "failed" },
            "op": { "const": "client_init" },
            "message": { "const": "ClinGen client initialization failed." }
          },
          "required": ["status", "op", "message"],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["failed", "timed_out"] },
            "op": { "const": "gene_lookup" },
            "message": { "enum": ["ClinGen gene lookup failed; gene-validity absence is unconfirmed.", "ClinGen gene lookup timed out; gene-validity absence is unconfirmed."] }
          },
          "required": ["status", "op", "message"],
          "allOf": [
            { "if": { "properties": { "status": { "const": "failed" } } }, "then": { "properties": { "message": { "const": "ClinGen gene lookup failed; gene-validity absence is unconfirmed." } } } },
            { "if": { "properties": { "status": { "const": "timed_out" } } }, "then": { "properties": { "message": { "const": "ClinGen gene lookup timed out; gene-validity absence is unconfirmed." } } } }
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["failed", "timed_out"] },
            "op": { "const": "gene_validity_download" },
            "message": { "enum": ["ClinGen gene-validity download failed.", "ClinGen gene-validity download timed out."] }
          },
          "required": ["status", "op", "message"],
          "allOf": [
            { "if": { "properties": { "status": { "const": "failed" } } }, "then": { "properties": { "message": { "const": "ClinGen gene-validity download failed." } } } },
            { "if": { "properties": { "status": { "const": "timed_out" } } }, "then": { "properties": { "message": { "const": "ClinGen gene-validity download timed out." } } } }
          ],
          "additionalProperties": false
        }
      ]
    },
    "dosageStatus": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["data", "empty"] },
            "op": { "const": "gene_dosage_download" }
          },
          "required": ["status", "op"],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "const": "failed" },
            "op": { "const": "client_init" },
            "message": { "const": "ClinGen client initialization failed." }
          },
          "required": ["status", "op", "message"],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["failed", "timed_out"] },
            "op": { "const": "gene_lookup" },
            "message": { "enum": ["ClinGen gene lookup failed; dosage-sensitivity absence is unconfirmed.", "ClinGen gene lookup timed out; dosage-sensitivity absence is unconfirmed."] }
          },
          "required": ["status", "op", "message"],
          "allOf": [
            { "if": { "properties": { "status": { "const": "failed" } } }, "then": { "properties": { "message": { "const": "ClinGen gene lookup failed; dosage-sensitivity absence is unconfirmed." } } } },
            { "if": { "properties": { "status": { "const": "timed_out" } } }, "then": { "properties": { "message": { "const": "ClinGen gene lookup timed out; dosage-sensitivity absence is unconfirmed." } } } }
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": { "enum": ["failed", "timed_out"] },
            "op": { "const": "gene_dosage_download" },
            "message": { "enum": ["ClinGen gene-dosage download failed.", "ClinGen gene-dosage download timed out."] }
          },
          "required": ["status", "op", "message"],
          "allOf": [
            { "if": { "properties": { "status": { "const": "failed" } } }, "then": { "properties": { "message": { "const": "ClinGen gene-dosage download failed." } } } },
            { "if": { "properties": { "status": { "const": "timed_out" } } }, "then": { "properties": { "message": { "const": "ClinGen gene-dosage download timed out." } } } }
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "additionalProperties": true
}
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