Best Skills Runner

best-skills-runner

The data pipeline behind [**LinklyAI/best-skills**](https://github.com/LinklyAI/best-skills) — a daily, cross-ecosystem ranking of AI agent skills.

[](https://github.com/LinklyAI/best-skills/actions/workflows/daily.yml) [](https://github.com/LinklyAI/best-skills-runner/actions/workflows/probe.yml) [](LICENSE)

Every skills registry only sees its own ecosystem: skills.sh counts Claude/Vercel CLI installs, ClawHub counts OpenClaw downloads, SkillHub counts installs from China — and none of them see social traction. This pipeline collects all of them once a day, merges them into a single entity graph, computes nine rankings, validates the output, and publishes it as open CSV.

Runs on GitHub Actions every day at 01:17 UTC — the scheduled workflow lives in the [data repo](https://github.com/LinklyAI/best-skills/blob/main/.github/workflows/daily.yml), which checks this one out and runs it. Everything the pipeline produces lives in that repo; there is no database and no server.

Pipeline

sources/     collect raw data — skills.sh · ClawHub · SkillHub · GitHub · social buzz
   ↓
rank/        entity resolution (fully-qualified keys, cross-platform links only on
             exact upstream_url evidence) → within-platform log percentiles →
             nine rankings + a five-dimension weighted index
   ↓
publish/     write CSVs to ../best-skills/data/YYYY-MM-DD/{raw,rankings}/
             render the ranking previews into the data repo's READMEs, one per language
   ↓
validate.ts  publication gate — row-count floors, sort monotonicity, rank continuity,
             directory closure, day-over-day drift, sanity anchors
   ↓          (only if everything passes)
publish/     refresh data/latest/ → commit → p