tooluniverse-residue-functional-mechanism-interpretation

Explains why protein residues are functionally critical using structural, UniProt, SAE, and DMS evidence.

1.7k|254|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-residue-functional-mechanism-interpretation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tooluniverse-residue-functional-mechanism-interpretation
Source: https://github.com/mims-harvard/ToolUniverse/tree/main/plugins/tooluniverse/skills/tooluniverse-residue-functional-mechanism-interpretation
Command: npx skills add https://github.com/mims-harvard/ToolUniverse --skill tooluniverse-residue-functional-mechanism-interpretation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, matplotlib, statsmodels.

What problem does it solve?

When you have a set of protein residues — from DMS hotspot screens, ClinVar recurrent variants, literature reports, or conservation analysis — you need to explain why they matter biologically. A residue in a catalytic triad means something different from one in a ligand pocket, a protein-protein interface, or a PTM site, and no single data source can distinguish these cases.

Core Features & Use Cases

  • Multi-evidence mechanism calling: Combines structural annotation (interface, ligand pocket, core, secondary structure), UniProt features (active sites, binding sites, PTMs, disulfides), optional SAE feature evidence, and optional DMS effect data to assign each residue cluster a mechanism: catalytic, ligand-binding, interface, structural-core, PTM, regulatory, or unknown.
  • Flexible input paths: Accepts user-provided residue positions from any source (ClinVar, literature, conservation) or auto-detects top-K hotspots from a DMS effect matrix, with a mandatory premise check that verifies user-named positions actually rank as hotspots in the given assay.
  • Publication-ready visualization: Generates an annotated DMS heatmap with sequence strip, structural annotation track, and per-hotspot mechanism callouts, with explicit alignment verification to avoid off-by-N registration errors.
  • Use Case: A researcher studying KRAS asks why positions 12 and 13 are critical. The skill checks their DMS rank, finds them in the GTP-binding P-loop via structural and UniProt evidence, and reports a ligand-binding mechanism with supporting SAE feature labels.

Quick Start

Explain why residues 12, 13, and 116 of KRAS (UniProt P01116, PDB 6VJJ chain A) are functionally critical using structural, UniProt, and SAE evidence.

Frequently Asked Questions about tooluniverse-residue-functional-mechanism-interpretation

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

FAQPage Schema
How do I interpret DMS hotspot residues mechanistically?

Detect top-K positions by max effect from the DMS matrix, cluster adjacent residues, then gather structural annotations, UniProt features, and optional SAE feature evidence per cluster. The skill synthesizes these layers into a mechanism call such as catalytic, ligand-binding, interface, or structural-core.

Can I analyze residues from ClinVar or literature instead of a DMS map?

Yes. Pass positions directly as user_provided_positions and the skill skips DMS hotspot detection entirely. Structural, UniProt, and mechanism synthesis layers still run; DMS data becomes optional enrichment rather than a required input.

What is the difference between this and single-variant interpretation skills?

This skill explains which residues matter and why across a set, producing per-cluster mechanism calls. Single-variant skills like protein-lof-mechanism or protein-sae-variant-interpretation focus on one mutation's signature in isolation.

Does the residue mechanism analysis work without an experimental PDB structure?

Structural evidence requires a PDB structure containing the relevant ligand or partner complex; a wrong structure blinds that evidence layer. If no experimental structure exists, AlphaFold predictions can provide pLDDT context, and the skill falls back to UniProt and SAE evidence.

What are the limitations of automated residue mechanism calling?

UniProt annotations are sparse for non-model proteins, single-position clusters lack statistical power for permutation tests, and SAE feature labels are interpretive hints rather than ground truth. The mechanism call is a reasoned synthesis of evidence, not a direct measurement.