Health Scoring Formula
Every tool in the graph has a health_score (0–100) computed from five weighted factors. This page explains each factor, how scores are calculated, and how they influence search results.
Overall Formula
health_score = w1 × commit_frequency
+ w2 × issue_response
+ w3 × release_cadence
+ w4 × community_size
+ w5 × documentation_qualityWeight Breakdown
Factor Details
Each factor produces a sub-score from 0 to 100 before weighting:
Commit Frequency
25%How actively the project is maintained, measured by commit activity over the last 90 days.
90–100:Daily commits (or near-daily)70–89:Multiple commits per week40–69:Weekly to bi-weekly commits10–39:Monthly commits or less0–9:No commits in 90+ days
Issue Response
20%How quickly maintainers respond to new issues, measured by median first-response time.
90–100:Median response < 24 hours70–89:Median response < 3 days40–69:Median response < 7 days10–39:Median response < 30 days0–9:No response or issues disabled
Release Cadence
20%How regularly new versions are published, based on the frequency and recency of releases.
90–100:Regular releases (at least monthly)70–89:Releases every 1–3 months40–69:Releases every 3–6 months10–39:Releases every 6–12 months0–9:No release in 12+ months
Community Size
20%Overall community engagement — stars, forks, contributors, and download counts.
90–100:10k+ stars, 100+ contributors70–89:1k–10k stars, 20+ contributors40–69:100–1k stars, 5+ contributors10–39:10–100 stars, 2+ contributors0–9:Fewer than 10 stars
Documentation Quality
15%Presence and quality of documentation — README completeness, dedicated docs site, and API reference.
90–100:Comprehensive docs site + API reference + examples70–89:Docs site or thorough README with examples40–69:README with installation and basic usage10–39:Minimal README (description only)0–9:No README or empty repository
Tier Thresholds
Health scores map to four human-readable tiers:
Actively maintained, responsive community, regular releases, and excellent documentation.
Well-maintained with reasonable activity. Minor gaps in release cadence or documentation.
Moderately active. May have slower issue response or infrequent releases.
Low activity, slow or no responses, stale releases. May be abandoned or unmaintained.
How Health Affects Search
Health scores influence search results in two ways:
- Stage 3 boost: During graph reranking, tools with higher health scores receive a slight boost to their final ranking score. This means healthier tools surface higher when relevance is otherwise equal.
- Result display: Health tier and score are included in every tool result returned to agents, helping them make informed decisions about tool quality.
Recalculation schedule