fork-health-score

Compute 0–100 health scores for repository forks using push recency, skill count, and PR throughput.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill fork-health-score
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fork-health-score
Source: https://github.com/Atrium-Hermes/atrium-lighthouse/tree/main/skills/fork-health-score
Command: npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill fork-health-score

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Weekly per-fork health tier synthesizing push recency + enabled skill count + 30d PR activity into ACTIVE/WARM/STALE/QUIET buckets; fleet health ratio + top-10 ACTIVE table; silent when nothing moves

Core Features & Use Cases

  • Aggregates per-fork signals (push recency, enabled skill count, PR throughput) into a single SCORE and tier to quickly gauge health.
  • Generates a top-10 ACTIVE leaderboard for quick operator visibility and tribal knowledge sharing.
  • Outputs a leaderboard article and per-fork state for auditing, trend analysis, and drift detection.

Quick Start

Run the fork-health-score audit to generate the weekly leaderboard and update the state and article accordingly.

Frequently Asked Questions about fork-health-score

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

FAQPage Schema
How do I calculate a health score for GitHub forks?

Calculate a GitHub fork health score by aggregating push recency, enabled skill count, and 30-day PR throughput into a unified 0–100 metric. This synthesizes multiple repository signals into a single score to quickly gauge fork activity and overall fleet health.

How does fork health monitoring handle inactive or bot-driven repositories?

Fork health monitoring handles inactive repositories by bucketing them into STALE or QUIET tiers based on PR throughput and push recency. It excludes bot accounts from the audit to ensure the generated fleet leaderboard reflects genuine human developer activity.

Can I audit fork activity using live GitHub API calls instead of stored data?

Yes, you can audit fork activity using live GitHub API calls when fresh cohort data is unavailable. The audit automatically falls back to live API requests to retrieve push recency and PR throughput, ensuring the fork health score remains accurate and up-to-date.

What is the best way to rank active forks across a large repository fleet?

The best way to rank active forks is generating a top-10 ACTIVE leaderboard using the computed 0–100 health score. This approach applies cohort data to bucket forks into ACTIVE, WARM, STALE, or QUIET tiers, providing operators clear visibility into fleet health.

How do I generate a weekly fork health leaderboard and state files?

Generate a weekly fork health leaderboard by running the audit to compute per-fork scores and update state files. This outputs a leaderboard article and per-fork breakdown for auditing, trend analysis, and drift detection across the repository fleet.