tooluniverse-proteomics-analysis
Mass-spec proteomics analysis — protein identification, quantification (LFQ, TMT, iTRAQ), differential expression (tumor vs normal, treatment vs control), PTM identification, and pathway enrichment on protein lists. Use when you have proteomics MS output, asking about protein abundance differences,
By mims-harvard · 394 installs
npx skills add mims-harvard/tooluniverse --skill tooluniverse-proteomics-analysis
Source repository · Upstream listing
Proteomics Analysis
RULE ZERO — Check for pre computed results FIRST
Before following any instruction below, scan the data folder for:
executed.ipynb → read with tu run read executed notebook '{"data folder":"<path ","search":"<keyword "}' and cite its cell outputs as the authoritative answer
Pre computed result files (CSV/TSV with names like results , deseq , enrich , stats , simplified.csv ) → read directly and report the requested value
Canonical analysis scripts ( analysis.R , run .py , find .R , .Rmd ) → execute as is and read the output
Only follow this skill's re analysis recipe below if none of the above exist. Re running from raw data produces different numbers than the published answer and is much slower (often 5 10× turn count).
Comprehensive analysis of mass spectrometry based proteomics data from protein identification through quantification, differential expression, post translational modifications, and systems level interpretation.
When to Use This Skill
Triggers : User has proteomics MS output files, asks about protein abundance/expression, differential protein expression, PTM analysis, protein RNA correlation, multi omics integration involving proteomics, protein complex/interaction analysis, or proteomics biomarker discovery.
COMPUTE, DON'T DESCRIBE
When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.
Core Capabilities
Data Import : MaxQuant, Spectronaut, DIA NN, Proteome Discoverer, FragPipe outputs
Quality Control : Missing value analysis, intensity distributions, sample clustering
Normalization : Median, quantile, TMM, VSN — choice depends on experimental design (see Interpretation Framework)
Imputation : MinProb (MNAR), KNN (MAR), QRILC for missing values
Differential Expression : Limma, DEP, MSstats for statistical testing
PTM Analysis : Phospho site localization, PTM enrichment, kinase prediction
Protein RNA Integration : Correlation analysis, translation efficiency
Pathway Enrichment : Over representation and GSEA for protein sets
PPI Analysis : Protein complex detection, interaction networks via STRING/IntAct
Workflow Overview
See [PHASE DETAILS.md](PHASE DETAILS.md) for detailed procedures per phase.
Integration with ToolUniverse
Skill Used For Phase
tooluniverse gene enrichment Pathway enrichment Phase 5
tooluniverse protein interactions PPI networks Phase 6
tooluniverse rnaseq deseq2 RNA seq for integration Phase 7
tooluniverse multi omics integration Cross omics analysis Phase 7
tooluniverse target research Protein annotation Phase 8
Quantified Minimums
At least 500 proteins quantified (human: 3,000+ is reasonable; 10,000+ is deep coverage)
At least 3 biological replicates per condition (non negotiable for reliable statistics)
Filter to proteins with 2+ unique peptides (single peptide IDs are not reported as DE)
Statistical test: limma or t test with Benjamini Hochberg multiple testing correction
Pathway enrichment: at least one method (GO, KEGG, or Reactome)
Report must include: QC summary, DE results with volcano plot, pathway analysis, visualizations
Interpretation Framework
Starting Point: Experimental Design
Quantitative proteomics compares protein abundance. LOOK UP DON'T GUESS — always verify the experimental method, platform, and replicate count before choosing an analysis strategy.
Quantification strategy decision tree:
Cell culture, high accuracy needed → SILAC (ratios within same MS run, most accurate, but culture only)
Multiple conditions, multiplexing needed → TMT/iTRAQ (up to 18 plex in one run; TMM/VSN normalization; beware ratio compression artifact that reduces observed fold changes)
Discovery study, flexible design → Label free (LFQ) (intensity based; median/quantile normalization; more missing values; wider dynamic range)
Replicates : n < 3 = unreliable fold changes (variance cannot be estimated). Minimum n = 3 biological replicates; n = 4 preferred for clinical samples. Never report significance from duplicates.
FDR cutoff : Benjamini Hochberg correction mandatory. FDR < 0.05 standard; FDR < 0.01 stringent. Never report unadjusted p values alone.
Protein Identification Reasoning
Protein identification from MS data follows a logical chain. LOOK UP DON'T GUESS — search UniProt and STRING for protein annotation rather than inferring function from name alone.
1. Peptide mass fingerprinting (PMF) : Intact protein digested → measured peptide masses compared against theoretical digest of all database proteins. A match requires =4 peptides covering =15% of the protein sequence. Single peptide hits are unreliable (could match multiple proteins).
2. Tandem MS (MS/MS) : Fragment ion spectra matched to peptide sequences via search engines (Andromeda, SEQUEST, X!Tandem). Each peptide spectrum match (PSM) scored; only PSMs above FDR threshold count. Unique peptides (mapping to one protein) are essential — shared peptides cannot distinguish between protein isoforms.
3. Protein inference : Multiple peptides → protein groups. When peptides are shared between homologs, report the protein group (not individual proteins). Use proteins api search or UniProt search to resolve ambiguous protein groups.
4. Coverage matters : 2+ unique peptides is the minimum for a confident protein ID. Proteins identified by a single unique peptide should be flagged as tentative.
Post Translational Modification (PTM) Analysis Reasoning
PTMs (phosphorylation, ubiquitination, acetylation, glycosylation) add biological complexity beyond protein abundance.
1. Site localization : A phospho site is confidently localized only if the localization probability 0.75 (MaxQuant) or ptmRS score 75 (Proteome Discoverer). Ambiguous sites should not be reported as specific residue modifications.
2. Enrichment is required : Without phospho enrichment (TiO2, IMAC), only the most abundant phosphopeptides are detected (~1% of phosphoproteome). An absence of a phospho site in non enriched data does not mean it is absent biologically.
3. Kinase prediction : If phospho sites are identified, predict upstream kinases using motif analysis. Cross reference with OpenTargets get target safety profile by ensemblID for kinase disease associations. LOOK UP kinase substrate relationships in PhosphoSitePlus rather than guessing from sequence motif alone.
4. Stoichiometry : A protein can be 5% or 95% phosphorylated at a given site — this matters enormously for function but is hard to measure. Report whether data supports stoichiometry estimation or only site identification.
Differential Expression Thresholds
Strong : padj < 0.01, FC 2.0, ≥5 unique peptides, <20% missing
Moderate : padj 0.01 0.05, FC 1.5 2.0, 2 5 peptides, 20 50% missing
Weak/unreliable : padj 0.05 0.1, FC 1.2 1.5, 1 2 peptides (single peptide proteins are unreliable), 50% missing (imputation needed)
Evidence Grading
T1 : Validated by orthogonal method (Western blot, PRM) + functional study
T2 : Significant DE (padj < 0.05, FC 1.5) in 2+ biological replicates
T3 : Significant DE in 1 experiment, or significant but low FC
T4 : Identified but not quantified, or single peptide identification
Synthesis Questions
1. How many proteins are differentially expressed? ( 500 DE proteins suggests global perturbation; <50 suggests targeted effect)
2. Are key pathway proteins concordantly regulated? (all subunits of a complex changing = high confidence)
3. Do proteomics results correlate with transcriptomics? (low correlation is common — post translational regulation)
4. Are PTM changes driving the phenotype? (check phosphoproteomics if available)
5. What is the coverage relative to the expected proteome? (human: ~10K quantified is good; <3K is limited)
Limitations
Platform specific : Optimized for MS based proteomics (not Western blot quantification)
Missing values : High missing rate ( 50% per protein) limits statistical power
PTM analysis : Requires enrichment protocols for comprehensive PTM profiling
Absolute quantification : Relative abundance only (unless TMT/SILAC used)
Protein isoforms : Typically collapsed to gene level
Dynamic range : MS has limited dynamic range vs mRNA sequencing
References
Methods : MaxQuant (doi:10.1038/nbt.1511), Limma for proteomics (doi:10.1093/nar/gkv007), DEP workflow (doi:10.1038/nprot.2018.107)
Databases : [STRING](https://string db.org), [PhosphoSitePlus](https://www.phosphosite.org), [CORUM](https://mips.helmholtz muenchen.de/corum)
Reference Files
[PHASE DETAILS.md](PHASE DETAILS.md) Detailed procedures for each analysis phase, including report template