cosmic-toolkit

Query COSMIC Cancer Gene Census to annotate gene symbols and return JSON.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dakesan/cc-dnawork-plugin --skill cosmic-toolkit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cosmic-toolkit
Source: https://github.com/dakesan/cc-dnawork-plugin/tree/main/scientific-skills/cosmic-toolkit
Command: npx skills add https://github.com/dakesan/cc-dnawork-plugin --skill cosmic-toolkit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, typer, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you interrogate COSMIC Cancer Gene Census data to determine if genes are known cancer genes and retrieve rich gene-level properties for research or reporting.

Core Features & Use Cases

  • COSMIC Query: Check if genes are in the cancer gene census and fetch properties.
  • JSON Output: Return all census columns as JSON for downstream analyses.
  • Flexible Inputs: Query a single gene, multiple genes, or from a file.

Quick Start

Query TP53 and BRCA1 with default census data and save results as JSON.

Frequently Asked Questions about cosmic-toolkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I annotate genes with COSMIC cancer gene data?

COSMIC annotation checks if gene symbols are in the Cancer Gene Census and retrieves properties like Tier, Hallmark, Tumour Types, and Role in Cancer. Query single genes, multiple genes, or from a file using case-insensitive symbol matching, then export results as JSON containing all census columns.

Can I query cancer genes from a file input?

Yes, the Skill supports flexible inputs: single gene symbols, multiple genes, or file-based inputs. Load your gene list, perform case-insensitive matching against the Cancer Gene Census CSV, and retrieve annotated results with all census properties in JSON format.

What cancer gene properties does COSMIC Census provide?

The Cancer Gene Census returns Tier classification, Hallmark status, Tumour Types (both Somatic and Germline), Role in Cancer, and Cancer Syndrome information. All CSV columns are included in the JSON output for downstream research and reporting.

How do I use pandas with COSMIC gene annotation?

Pandas loads and processes the Cancer Gene Census CSV data. The Skill uses pandas for case-insensitive symbol matching, normalizing missing values, and structuring the annotated results into JSON payloads with all census columns preserved.

Can I specify a custom Cancer Gene Census file path?

Yes, the Skill supports configurable census file paths so you can use custom or updated Census versions. You can also set optional output destinations to save JSON results to a specified location.

What format does the gene annotation output?

Gene annotation outputs as JSON containing all Cancer Gene Census columns for each queried gene. This structured format enables direct integration with downstream analyses, databases, or reporting pipelines.