weighted-engagement-scoring

Combines normalized engagement metrics into a weighted composite score for ranking content.

13|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/aaddrick/written-voice-replication --skill weighted-engagement-scoring-aaddrick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weighted-engagement-scoring
Source: https://github.com/aaddrick/written-voice-replication/tree/main/.claude/skills/weighted-engagement-scoring
Command: npx skills add https://github.com/aaddrick/written-voice-replication --skill weighted-engagement-scoring-aaddrick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy.

What problem does it solve? Raw engagement metrics like votes, upvote ratios, comment counts, sentiment, and recency live on incompatible scales, so combining them naively produces meaningless rankings dominated by whichever metric has the largest numbers. This Skill normalizes each signal to [0, 1], applies documented weights, and produces a validated composite engagement score for identifying high-value content. ## Core Features & Use Cases - Multi-Signal Normalization: Applies min-max, robust percentile, log, or rank-based normalization per metric based on distribution shape. - Documented Weighting with Sensitivity Analysis: Requires a rationale for every weight and tests ranking stability under +/-10% weight perturbations. - Validation and Reporting: Validates top-10 and bottom-10 ranked items against human judgment and writes findings to a structured analysis report. - Use Case: Given a Reddit data export with scores, upvote ratios, comment counts, sentiment, and timestamps, rank all posts by a composite engagement score to select the top 10% most influential discussions for downstream analysis. ## Quick Start Use the weighted-engagement-scoring skill to rank the posts in my dataset by a composite engagement score combining votes, comments, sentiment, and recency.

Frequently Asked Questions about weighted-engagement-scoring

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

FAQPage Schema
How do I combine multiple engagement metrics into one score?

Normalize each metric to the [0, 1] range first, then compute a weighted sum where the weights sum to 1.0. Each weight needs a documented rationale, and the result should be validated by manually inspecting the top and bottom ranked items.

Which normalization method should I use for skewed metrics like vote counts?

Use log min-max normalization for power-law distributed counts like scores and comment volumes, since a single viral outlier would otherwise dominate the range. Use robust percentile-based min-max for moderate skew and standard min-max for bounded metrics like ratios.

Can I use equal weights for all engagement metrics?

Equal weights are acceptable only when explicitly justified with the rationale that no signal is a priori more important. Arbitrary or undocumented weights make the analysis irreproducible, so every weight choice needs a one-sentence justification.

Why is my composite engagement score dominated by one metric?

This happens when metrics are combined without normalization, letting the metric with the largest numerical range control the result. It can also occur when two highly correlated metrics (r > 0.85) double-count one signal, so check the correlation matrix before weighting.

When should I not use a weighted composite engagement score?

Avoid it when only one metric is available, when ranking users rather than content, or when comparing scores across different platforms without recalibrating weights. Also avoid presenting it as a quality metric without including a sentiment signal, since high engagement includes controversy and rage-bait.

How do I know if my engagement score rankings are reliable?

Run a sensitivity analysis by perturbing each weight by +/-10% and measuring top-N overlap. Above 90% overlap means the ranking is robust, 50-70% means results depend heavily on weight choices, and below 50% means the composite score is unreliable.