organ-aging-studio

Decomposes Goeminne proteomic organ age predictions into per-protein NPX-coefficient contributions.

1.1k|257|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill organ-aging-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: organ-aging-studio
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/organ-aging-studio
Command: npx skills add https://github.com/ClawBio/ClawBio --skill organ-aging-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy, requests.

What problem does it solve?

Proteomic biological age clocks normally return a single black-box number per organ, making it impossible to explain which proteins drive the prediction. This Skill breaks every Goeminne organ-aging clock prediction down into individual protein contributions (NPX × coefficient) so results are inspectable and explainable.

Core Features & Use Cases

  • Per-protein contribution breakdown: Ranks proteins by absolute coefficient and reports each protein's NPX value, coefficient, and contribution to predicted organ age.
  • Multi-organ and multi-generation support: Runs any organ from Goeminne et al. (2025), with gen1 chronological-age models or gen2 mortality-hazard models converted to years via the Gompertz transform.
  • Protein filtering for demos: --top-n and --min-abs-coef flags let you show only the strongest drivers for a single sample.
  • Structured outputs: Writes a Markdown report, machine-readable JSON, a long-format protein_contributions.csv table, and a replayable commands.sh.
  • Use Case: A researcher has an Olink NPX table for one patient and wants to explain why the Heart clock predicts accelerated aging. They run the skill with --organs Heart --sample-id PATIENT_001 --top-n 5 and get a ranked list of the five proteins driving that prediction.

Quick Start

Ask the agent to run the organ aging studio demo on the bundled synthetic Olink data and show which proteins drive the Heart and Brain age predictions for sample DEMO_000.

Frequently Asked Questions about organ-aging-studio

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

FAQPage Schema
How do I explain which proteins drive a proteomic organ age prediction?

Run the skill on an Olink NPX table with a sample_id column and protein gene-symbol columns. It computes each protein's contribution as NPX times its published coefficient and ranks them by absolute coefficient in report.md, result.json, and protein_contributions.csv.

What input format does the Goeminne organ aging clock require?

The input must be an Olink NPX table in CSV, TSV, or gzipped form with a sample_id column plus protein columns named by gene symbol. NPX values are already log2-scaled, so do not log-transform them again before running.

Can I use SomaLogic or mass-spec proteomics data with this clock?

Not directly. Non-Olink inputs must be standardised and rescaled using the standard deviations from Table S3 of the Goeminne et al. paper before prediction, because the published coefficients assume Olink NPX scaling.

What is the difference between gen1 and gen2 clock generations?

Gen1 models predict chronological age directly in years. Gen2 models predict mortality hazard as a log-hazard, which the skill converts to years using the Gompertz transform before reporting.

Why do filtered predictions differ from the published clock results?

The --top-n and --min-abs-coef flags intentionally drop part of the published model, so the resulting ages are partial-model illustrations rather than the validated full-clock outputs. Run without filters for complete predictions.

Is the organ aging studio output suitable for clinical diagnosis?

No. The skill is for educational and research use only and is not a medical device. It must not be used for clinical diagnosis, and demo data is synthetic with no real patient information.