mims-harvard/tooluniverse

tooluniverse-protein-modification-analysis

Post-translational modification (PTM) analysis — phosphorylation, ubiquitination, acetylation, glycosylation, methylation.

First seen Mar 25, 2026

Installation

$ npx skills add mims-harvard/tooluniverse --skill tooluniverse-protein-modification-analysis

Summary

  • Post-translational modification (PTM) analysis — phosphorylation, ubiquitination, acetylation, glycosylation, methylation.
  • Uses iPTMnet (sites + enzymes), ProtVar (functional consequences), UniProt (baseline), STRING, ELM (linear motifs), MassIVE/ProteomeXchange (experimental).
  • Use for PTM site annotation, kinase-substrate identification, and PTM-disease associations.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from mims-harvard/tooluniverse · top by installs.

npx skills add mims-harvard/tooluniverse

Browse all from mims-harvard/tooluniverse

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.7K
License LICENSE
Default branch main
Open issues 9
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,191 B
  • docs SUMMARY.md 422 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 217 installs

SKILL.md

Protein Post-Translational Modification Analysis

Comprehensive PTM analysis using iPTMnet (primary), ProtVar (functional context), UniProt (baseline), STRING (interactions), ELM (linear motifs), and MassIVE/ProteomeXchange (experimental data).

LOOK UP DON'T GUESS

  • PTM sites/enzymes: iPTMnetgetptm_sites
  • Functional consequence: ProtVargetfunction + iPTMnetgetptm_ppi
  • Proteoforms: iPTMnetgetproteoforms
  • Linear motifs: ELMgetinstances

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.

Domain Reasoning

PTMs are context-dependent: same phosphorylation site can activate or inhibit depending on kinase and effectors. Always check: which enzyme, what functional consequence, in what cell context.


KEY PRINCIPLES

  1. Disambiguation first -- resolve to UniProt accession before iPTMnet calls
  2. iPTMnet is SOAP-style -- every call requires operation parameter
  3. Evidence-graded -- distinguish experimental (T1) from predicted (T4)
  4. English-first queries

Workflow

Phase 0: Protein Disambiguation → UniProt accession
Phase 1: PTM Site Inventory → iPTMnet_get_ptm_sites
Phase 2: Proteoform Analysis → iPTMnet_get_proteoforms
Phase 3: PTM-Dependent Interactions → iPTMnet_get_ptm_ppi
Phase 4: Functional Context → ProtVar_get_function at key sites
Phase 4b: Linear Motif Context → ELM_get_instances for SLiM overlap
Phase 4c: Experimental Data → MassIVE/ProteomeXchange
Phase 5: Synthesis & Report

Phase 0: Disambiguation

  • iPTMnetsearch(operation="search", searchterm="TP53", role="Substrate") -- find UniProt IDs
  • If user provides UniProt accession directly, use it
  • Select human entry if multiple hits

Phase 1: PTM Sites

iPTMnetgetptmsites(operation="getptmsites", uniprotid="P04637") -- returns position, residue, modification type, enzyme, evidence. Group by modification type. Fallback: UniProtgetentrybyaccession PTM annotations.

Phase 2: Proteoforms

iPTMnetgetproteoforms(operation="getproteoforms", uniprotid=...) -- distinct PTM combinations. Focus on those with functional/disease annotations if >20.

Phase 3: PTM-Dependent Interactions

iPTMnetgetptmppi(operation="getptmppi", uniprotid=...) -- interacting protein, PTM site, effect (enables/disrupts). Supplement with STRINGgetinteractionpartners(identifiers=gene, species=9606, requiredscore=700).

Phase 4: Functional Context

ProtVargetfunction(accession=..., position=N, variant_aa=AA) -- domain, active site, binding site, conservation. Grade: active-site PTM > domain-core > disordered region.

Phase 4b: Linear Motifs (ELM)

ELMgetinstances(operation="getinstances", uniprotid=..., motiftype="MOD") -- MOD = modification sites, DEG = degradation signals. Cross-reference with Phase 1 PTM positions. ELMlistclasses(operation="listclasses") for motif details.

Phase 4c: Experimental Data

MassIVEsearchdatasets(species="9606"), MassIVEgetdataset(accession="MSV...") for public MS datasets.


Evidence Grading

Tier Criteria
T1 PTM at validated active/binding site with functional data
T2 PTM in structured domain with ProtVar annotation
T3 Correlation data only (mass spec detection)
T4 Predicted, no experimental validation

Tool Parameter Reference

Tool Key Params
iPTMnet_search operation="search", search_term, role
iPTMnetgetptm_sites operation="getptmsites", uniprot_id
iPTMnetgetproteoforms operation="getproteoforms", uniprotid
iPTMnetgetptm_ppi operation="getptmppi", uniprot_id
ELMgetinstances operation="getinstances", uniprotid, motif_type
ELMlistclasses operation="list_classes"
MassIVEsearchdatasets page_size, species

Critical: All iPTMnet and ELM tools require operation as first parameter (SOAP-style).


Fallbacks

Situation Fallback
Not in iPTMnet UniProt PTM/processing annotations
No PTM-PPI data STRING general PPI
No ProtVar data UniProt domain annotations
No ELM data Proceed with iPTMnet/UniProt only

Limitations

  • iPTMnet biased toward well-studied proteins
  • Proteoform data covers observed combinations only
  • PTM-PPI: only PTM-specific evidence; more PPIs exist in STRING