Methodology & policies

How AgentSpot decides what to list, how it ranks, and the rules we will not break.

What gets listed

A project is eligible when it meets a published popularity threshold: at least 100 GitHub stars, or at least 10,000 package downloads in the last 30 days (npm or PyPI). These thresholds are configuration, not opinion, and are shown on the Get listed page too.

Eligible projects are discovered automatically by a daily pipeline, or submitted by their authors. Either way, every entry is reviewed and approved before it goes live, and every link passes automated security vetting first (HTTPS, allowlisted code hosts, no URL shorteners, age and inflation heuristics, safe-browsing checks).

How popularity is measured

The primary signal is GitHub stars. Where available, package downloads (npm and PyPI, trailing 30 days) are a secondary signal. Closed-source projects without stars rank on downloads, or are marked unranked rather than pushed to the bottom.

We always display the raw numbers on every card and listing page so you can judge for yourself. For sorting only, we compute a normalized, log-scaled composite score in the range 0–100:

score = 100 × ( 0.7 × log10(stars + 1) / 6
             + 0.3 × log10(downloads + 1) / 8 )

The log scale keeps a handful of mega-projects from flattening everyone else, and the weights renormalize when a signal is missing so a downloads-only project is not penalized for having no stars. The score is only a sort key — it is not shown as a headline number and carries no editorial judgment.

Growth & trending

We compute momentum from our own daily snapshots: stars gained and percent change over the trailing 30 days. GitHub does not expose historical star counts cheaply, so history accumulates from the day we first track a project. To avoid misleading you, we show no growth figure until a project has at least 14 days of snapshots — never a fake zero. The "Trending" sort and the fast-growing filter exclude entries without enough history rather than showing them as flat. Growth is a lens for exploring — it never affects whether a project is listed.

No paid rankings — ever

No payment of any kind — sponsorship, curation fee, or anything else — can affect inclusion, ordering, the popularity score, or growth metrics. Sponsored placements are clearly labeled and shown in a separate slot that sits apart from the organic list, which is never reordered. A paid curated evaluation (a future feature) buys the evaluation work, not a passing verdict or a better rank. See the disclosure page for the details we are required to state.

Freshness & corrections

Metrics refresh daily and each listing shows its last verified date. Dead projects (deleted, archived, or 404) are flagged for delisting. Spotted a mistake or a bad link? Please report it — we act quickly.