bio-clinical-databases-somatic-signatures
Extract and analyze mutational signatures from somatic variants using SigProfiler or MutationalPatterns to characterize mutagenic processes
Install / Use
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-clinical-databases-somatic-signaturesInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of bio-clinical-databases-somatic-signatures
bio-clinical-databases-somatic-signatures scores 89/100 on our quality scale, 331st of 604 Data & Analytics skills we index.
Its SKILL.md is 8.4 KB long, well organised into 36 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
With 3,034 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
bio-clinical-databases-somatic-signatures compared with similar skills
All 4 of these similar skills score higher than bio-clinical-databases-somatic-signatures; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bio-clinical-databases-somatic-signatures (this skill)by FreedomIntelligence | 89 | 3.0k | 4mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install bio-clinical-databases-somatic-signatures?
- Run
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-clinical-databases-somatic-signatures. The install tabs above show the steps for each supported agent. - Which AI agents does bio-clinical-databases-somatic-signatures work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is bio-clinical-databases-somatic-signatures safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is bio-clinical-databases-somatic-signatures still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: bio-clinical-databases-somatic-signatures description: Extract and analyze mutational signatures from somatic variants using SigProfiler or MutationalPatterns to characterize mutagenic processes. Use when identifying DNA damage mechanisms or etiology in cancer genomes. tool_type: mixed primary_tool: SigProfilerExtractor
Version Compatibility
Reference examples tested with: MutationalPatterns 3.12+, SigProfilerExtractor 1.1+, numpy 1.26+
Before using code patterns, verify installed versions match. If versions differ:
- Python:
pip show <package>thenhelp(module.function)to check signatures - R:
packageVersion('<pkg>')then?function_nameto verify parameters
If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.
Somatic Mutational Signatures
"Extract mutational signatures from my tumor samples" → Decompose somatic mutation catalogs into mutational signatures (SBS, DBS, ID) to identify DNA damage mechanisms and mutagenic processes in cancer genomes.
- Python:
SigProfilerExtractor.sigpro()for de novo signature extraction - R:
MutationalPatterns::fit_to_signatures()for fitting to COSMIC signatures
SigProfiler Workflow
Goal: Extract de novo mutational signatures and decompose to COSMIC reference signatures from somatic VCFs.
Approach: Generate a 96-trinucleotide-context mutation matrix with SigProfilerMatrixGenerator, extract signatures via NMF with SigProfilerExtractor, and fit to COSMIC with SigProfilerAssignment.
Install and Generate Matrix
from SigProfilerMatrixGenerator import install as genInstall
from SigProfilerMatrixGenerator.scripts import SigProfilerMatrixGeneratorFunc as matGen
# Install reference genome (one-time)
genInstall.install('GRCh38')
# Generate mutational matrix from VCF
# Input: Directory containing VCF files
# Output: SBS96 matrix (96 trinucleotide contexts)
matrices = matGen.SigProfilerMatrixGeneratorFunc(
project='my_project',
genome='GRCh38',
vcfFiles='/path/to/vcf_directory',
plot=True,
exome=False # Set True for WES
)
Extract Signatures
from SigProfilerExtractor import sigpro as sig
# De novo signature extraction
# Determines optimal number of signatures automatically
sig.sigProfilerExtractor(
input_type='matrix',
output='extraction_output',
input_data='my_project/output/SBS/my_project.SBS96.all',
reference_genome='GRCh38',
minimum_signatures=1,
maximum_signatures=10,
nmf_replicates=100,
cpu=-1 # Use all cores
)
Decompose to COSMIC Signatures
from SigProfilerAssignment import Analyzer as Analyze
# Fit to known COSMIC signatures
Analyze.cosmic_fit(
samples='my_project/output/SBS/my_project.SBS96.all',
output='assignment_output',
input_type='matrix',
genome_build='GRCh38',
signature_database='SBS_GRCh38_GRCh38'
)
MutationalPatterns (R)
Goal: Analyze mutational spectra and fit to COSMIC signatures using the MutationalPatterns R package.
Approach: Load VCFs as GRanges, generate a 96-context mutation matrix against the reference genome, then fit to known COSMIC signatures or extract de novo via NMF.
Load and Analyze
library(MutationalPatterns)
library(BSgenome.Hsapiens.UCSC.hg38)
# Load VCF files
vcf_files <- list.files('vcf_dir', pattern = '\\.vcf$', full.names = TRUE)
sample_names <- gsub('.vcf', '', basename(vcf_files))
vcfs <- read_vcfs_as_granges(
vcf_files,
sample_names,
ref_genome = 'BSgenome.Hsapiens.UCSC.hg38'
)
# Generate 96-context mutation matrix
mut_mat <- mut_matrix(vcf_list = vcfs, ref_genome = 'BSgenome.Hsapiens.UCSC.hg38')
# Visualize spectrum
plot_96_profile(mut_mat)
Fit to COSMIC Signatures
# Load COSMIC signatures (v3.2)
cosmic_sigs <- get_known_signatures(muttype = 'snv')
# Fit samples to signatures
fit_result <- fit_to_signatures(mut_mat, cosmic_sigs)
# Plot contribution
plot_contribution(fit_result$contribution, cosmic_sigs, mode = 'absolute')
# Relative contribution
plot_contribution(fit_result$contribution, cosmic_sigs, mode = 'relative')
De Novo Extraction
# Extract de novo signatures using NMF
# Determine optimal rank
estimate <- estimate_rank(mut_mat, rank_range = 2:8, nrun = 50)
plot(estimate)
# Extract signatures
nmf_res <- extract_signatures(mut_mat, rank = 4, nrun = 100)
# Compare to COSMIC
cos_sim <- cos_sim_matrix(nmf_res$signatures, cosmic_sigs)
plot_cosine_heatmap(cos_sim)
COSMIC Signature Etiology
Goal: Interpret extracted signatures by mapping them to known mutagenic processes (e.g., UV, smoking, MMR deficiency).
Approach: Look up each dominant signature in a COSMIC etiology reference table and filter by contribution threshold.
# Common COSMIC signatures and their etiologies
SIGNATURE_ETIOLOGY = {
'SBS1': 'Spontaneous deamination (age-related)',
'SBS2': 'APOBEC activity',
'SBS3': 'Defective HR/BRCA1/2',
'SBS4': 'Tobacco smoking',
'SBS5': 'Unknown (age-related)',
'SBS6': 'MMR deficiency',
'SBS7a': 'UV exposure',
'SBS7b': 'UV exposure',
'SBS10a': 'POLE mutation',
'SBS10b': 'POLE mutation',
'SBS13': 'APOBEC activity',
'SBS15': 'MMR deficiency',
'SBS17a': 'Unknown',
'SBS17b': 'Unknown',
'SBS18': 'ROS damage',
'SBS22': 'Aristolochic acid',
'SBS26': 'MMR deficiency',
'SBS44': 'MMR deficiency',
}
def interpret_signatures(contributions):
'''Interpret signature contributions'''
interpretations = []
for sig, contrib in contributions.items():
if contrib > 0.05: # >5% contribution threshold
etiology = SIGNATURE_ETIOLOGY.get(sig, 'Unknown')
interpretations.append({
'signature': sig,
'contribution': contrib,
'etiology': etiology
})
return sorted(interpretations, key=lambda x: x['contribution'], reverse=True)
Signature Categories
| Category | Signatures | Mechanism | |----------|------------|-----------| | Age-related | SBS1, SBS5 | Spontaneous deamination, clock-like | | APOBEC | SBS2, SBS13 | Cytidine deaminase activity | | MMR deficiency | SBS6, SBS15, SBS26, SBS44 | Mismatch repair defects | | HR deficiency | SBS3 | BRCA1/2, homologous recombination | | POLE mutation | SBS10a, SBS10b | Proofreading defects | | UV damage | SBS7a, SBS7b | Pyrimidine dimers | | Smoking | SBS4 | Tobacco carcinogens | | Platinum therapy | SBS31, SBS35 | Treatment-related |
Cosine Similarity
Goal: Quantify how closely an extracted signature matches a COSMIC reference signature.
Approach: Compute cosine similarity between the two 96-dimensional signature vectors.
import numpy as np
def cosine_similarity(sig1, sig2):
'''Calculate cosine similarity between two signatures'''
dot_product = np.dot(sig1, sig2)
norm1 = np.linalg.norm(sig1)
norm2 = np.linalg.norm(sig2)
return dot_product / (norm1 * norm2)
# Threshold: >0.8 considered similar
# >0.9 considered same signature
Clinical Applications
Goal: Translate dominant mutational signatures into actionable clinical recommendations (e.g., PARP inhibitor eligibility).
Approach: Map signature identities to therapy implications and recommended confirmatory tests.
def signature_clinical_implications(dominant_signatures):
'''Clinical implications of mutational signatures'''
implications = []
for sig in dominant_signatures:
if sig == 'SBS3':
implications.append({
'signature': 'SBS3',
'implication': 'HR deficiency - may respond to PARP inhibitors',
'testing': 'Consider BRCA1/2 testing'
})
elif sig in ['SBS6', 'SBS15', 'SBS26', 'SBS44']:
implications.append({
'signature': sig,
'implication': 'MMR deficiency - may respond to immunotherapy',
'testing': 'Consider MSI testing'
})
elif sig in ['SBS2', 'SBS13']:
implications.append({
'signature': sig,
'implication': 'APOBEC activity - associated with high TMB',
'testing': 'Consider TMB assessment'
})
return implications
Related Skills
- clinical-databases/tumor-mutational-burden - TMB calculation
- variant-calling/somatic-variant-calling - Input variants
- data-visualization/heatmaps-clustering - Signature visualization
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
