bio-epidemiological-genomics-transmission-inference
Infer pathogen transmission networks and identify likely transmission pairs using TransPhylo and outbreak reconstruction algorithms. Estimate who-infected-whom from genomic and epidemiological data
Install / Use
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-epidemiological-genomics-transmission-inferenceInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of bio-epidemiological-genomics-transmission-inference
bio-epidemiological-genomics-transmission-inference scores 89/100 on our quality scale, 1586th of 4,700 Development & Engineering skills we index (top 34%).
Its SKILL.md is 7.6 KB long, well organised into 21 sections with 6 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-epidemiological-genomics-transmission-inference compared with similar skills
All 4 of these similar skills score higher than bio-epidemiological-genomics-transmission-inference; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bio-epidemiological-genomics-transmission-inference (this skill)by FreedomIntelligence | 89 | 3.0k | 4mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install bio-epidemiological-genomics-transmission-inference?
- Run
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-epidemiological-genomics-transmission-inference. The install tabs above show the steps for each supported agent. - Which AI agents does bio-epidemiological-genomics-transmission-inference 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-epidemiological-genomics-transmission-inference 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-epidemiological-genomics-transmission-inference 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-epidemiological-genomics-transmission-inference description: Infer pathogen transmission networks and identify likely transmission pairs using TransPhylo and outbreak reconstruction algorithms. Estimate who-infected-whom from genomic and epidemiological data. Use when investigating outbreak transmission chains or identifying superspreaders. tool_type: r primary_tool: TransPhylo
Version Compatibility
Reference examples tested with: BioPython 1.83+, TreeTime 0.11+, matplotlib 3.8+, numpy 1.26+, pandas 2.2+, scanpy 1.10+
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.
Transmission Inference
"Infer who infected whom in my outbreak" → Reconstruct transmission networks from genomic and epidemiological data to identify transmission pairs, superspreaders, and unsampled cases.
- R:
TransPhylo::inferTTree()for Bayesian transmission tree inference
TransPhylo in R
library(TransPhylo)
library(ape)
# Load dated phylogeny (from BEAST/TreeTime)
tree <- read.nexus('dated_tree.nexus')
# Convert to TransPhylo format
ptree <- ptreeFromPhylo(tree, dateLastSample = 2020.5)
# Estimate transmission tree
# Uses MCMC to sample from posterior distribution
res <- inferTTree(
ptree,
mcmcIterations = 100000,
startNeg = 0.1, # Initial within-host effective population
startOff.r = 2, # Initial R0 estimate
startOff.p = 0.5, # Initial sampling probability
startPi = 0.9, # Initial probability of being sampled
dateT = 2020.6 # End of outbreak observation
)
# Extract consensus transmission tree
ttree <- extractTTree(res)
# Get transmission pairs
pairs <- ttree$ttree[, c('infector', 'infectee', 'time')]
Prepare Data
def prepare_for_transphylo(dated_tree_file, sample_dates, output_prefix):
'''Prepare inputs for TransPhylo analysis
Requirements:
- Time-scaled phylogeny (from TreeTime or BEAST)
- Sample collection dates
- Tips must have matching names
TransPhylo estimates:
- Who infected whom
- Unsampled cases in the transmission chain
- R0 and generation time
'''
from Bio import Phylo
import pandas as pd
tree = Phylo.read(dated_tree_file, 'nexus')
# Verify all tips have dates
dates_df = pd.read_csv(sample_dates, sep='\t')
tip_names = {clade.name for clade in tree.get_terminals()}
dated_names = set(dates_df['name'])
missing = tip_names - dated_names
if missing:
print(f'Warning: {len(missing)} tips without dates: {missing}')
return {'tree': dated_tree_file, 'dates': sample_dates}
Interpret Results
# Analyze TransPhylo output
# Get median transmission tree
med_tree <- medTTree(res)
# Plot transmission tree
plot(med_tree)
# Get R0 estimate
r0_samples <- res$record[, 'off.r']
cat('R0 estimate:', median(r0_samples), '\n')
cat('95% CI:', quantile(r0_samples, c(0.025, 0.975)), '\n')
# Identify superspreaders
# Count number infected by each case
infections_per_case <- table(med_tree$ttree[, 'infector'])
superspreaders <- names(infections_per_case[infections_per_case > 3])
Python Alternative: outbreaker2 Wrapper
Goal: Infer likely transmission pairs from genomic distance and collection dates without requiring a dated phylogeny.
Approach: For each pair of samples, check that the potential infector was sampled earlier, that the time interval is compatible with the generation time, and that the SNP distance is consistent with direct transmission.
def infer_transmission_simple(distance_matrix, dates, generation_time=5):
'''Simplified transmission inference
Uses genomic distance and collection dates to infer likely
transmission pairs. Less sophisticated than TransPhylo but
doesn't require dated phylogeny.
Criteria for transmission pair (A -> B):
1. A collected before B
2. Genomic distance consistent with direct transmission
3. Time difference compatible with generation time
'''
import pandas as pd
import numpy as np
n = len(dates)
transmission_pairs = []
for i in range(n):
for j in range(n):
if i == j:
continue
time_diff = dates[j] - dates[i] # Days between collection
# Potential infector must be sampled first
if time_diff <= 0:
continue
# Check if time difference is compatible
# Generation time: time between infection of case and infection of secondary
# Serial interval: time between symptom onset (often used as proxy)
if time_diff > generation_time * 3: # Too much time
continue
# Check genomic distance
snp_diff = distance_matrix[i, j]
# Expected SNPs = rate * time
# For most pathogens, direct transmission = 0-5 SNP difference
expected_snps = (time_diff / 365) * 10 # Rough estimate
if snp_diff <= max(5, expected_snps * 2):
transmission_pairs.append({
'infector': i,
'infectee': j,
'snp_distance': snp_diff,
'days_between': time_diff,
'confidence': 'high' if snp_diff <= 2 else 'moderate'
})
return pd.DataFrame(transmission_pairs)
Network Visualization
Goal: Visualize the inferred transmission chain as a directed network graph showing who infected whom.
Approach: Build a directed NetworkX graph from transmission pairs and render it with spring layout, directional arrows, and labeled nodes.
def plot_transmission_network(pairs_df, metadata=None):
'''Visualize transmission network
Uses networkx to create directed graph of transmissions.
'''
import networkx as nx
import matplotlib.pyplot as plt
G = nx.DiGraph()
for _, row in pairs_df.iterrows():
G.add_edge(row['infector'], row['infectee'],
weight=row.get('confidence', 1))
# Layout
pos = nx.spring_layout(G)
# Draw
plt.figure(figsize=(12, 8))
nx.draw(G, pos, with_labels=True, node_color='lightblue',
node_size=500, arrows=True, arrowsize=20)
plt.title('Transmission Network')
return plt.gcf()
Superspreader Analysis
def identify_superspreaders(transmission_pairs, threshold=3):
'''Identify superspreading events
Superspreader: Individual who infected many others
Threshold typically 80/20 rule: 20% of cases cause 80% of transmission
Common threshold: >3 secondary cases
'''
from collections import Counter
infector_counts = Counter(transmission_pairs['infector'])
superspreaders = {k: v for k, v in infector_counts.items() if v >= threshold}
total_transmissions = sum(infector_counts.values())
ss_transmissions = sum(superspreaders.values())
print(f'Superspreaders (>{threshold} secondary cases):')
for ss, count in sorted(superspreaders.items(), key=lambda x: -x[1]):
print(f' Case {ss}: {count} secondary infections')
print(f'\nSuperspreading contribution: {ss_transmissions/total_transmissions:.1%}')
return superspreaders
Related Skills
- epidemiological-genomics/phylodynamics - Generate dated trees
- epidemiological-genomics/pathogen-typing - Identify outbreak clones
- data-visualization/interactive-visualization - Visualize transmission
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
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.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own 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.
