# Ranked Bar Race — effect skill for numbers & charts

> **For AI agents:** find the right skill in one call — `curl -s "https://varg.ai/how-to/api/search?q=<what the person wants>"` returns the matching how-to page and the best skills with install commands, as markdown (Russian works too). Full index: https://varg.ai/how-to/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the how-to page.

Ranked bars grow and overtake each other over time while the axis rescales and a year/date ticks.

- **Type:** [Effect](https://varg.ai/how-to/effects.md) · [Numbers & charts](https://varg.ai/how-to/browse/skills/numbers.md)
- **Slug:** `ranked-bar-race`
- **Status:** live
- **Publisher:** HeyGen (community)
- **License:** Apache-2.0
- **Source:** https://github.com/heygen-com/hyperframes/tree/main/registry/blocks/bar-chart-race
- **Works in:** Claude Code, Claude.ai, Codex, Cursor, OpenClaw, Gemini CLI, Any MCP client, varg Studio
- **Requires:** HyperFrames (npx hyperframes), Remotion, CapCut (by hand)
- **Cost:** Free — the take renders locally; generated footage, if any, bills by the model

## What it does

Built on [Bar Chart Race](https://github.com/heygen-com/hyperframes/tree/main/registry/blocks/bar-chart-race) by HeyGen (HyperFrames), Apache-2.0. The write-up and recipes below are varg's.

Horizontal bars with logos at their ends, sorted live, a big date counter in the corner; your product climbs to #1.

**When:** Market share, popularity over time, "fastest growing" stories.

**Watch out:** Do not run the race too fast; viewers need ~0.5–1 s per period to follow overtakes.

**Timing:** 0.5–1 s per period, smooth interpolation between periods, final hold 2 s.

**Also called:** bar chart race, ranking animation, leaderboard

### In HyperFrames

```bash
npx hyperframes add bar-chart-race
```
Feed the time series as variables; ranks and the axis are recomputed per frame from time.

### In Remotion

```tsx
const t = frame / (fps*0.8); const i0 = Math.floor(t), k = t - i0;
const values = series.map(s => s[i0] + (s[i0+1]-s[i0])*k);
const ranked = [...values.keys()].sort((a,b)=>values[b]-values[a]);
```

### In CapCut

Build in Flourish (Bar chart race template), screen-record the preview, import and trim.

### Ready-made components

- [Bar Chart Race](https://skills.varg.ai/component/hf.bar-chart-race/) (hyperframes): npx hyperframes add bar-chart-race
- [Data Chart](https://skills.varg.ai/component/hf.data-chart/) (hyperframes): npx hyperframes add data-chart

### Where this comes from

- [Flourish: how to make bar chart race visualizations](https://flourish.studio/blog/bar-chart-race/)

## Use when

- Market share, popularity over time, "fastest growing" stories.

## Not for

- Do not run the race too fast; viewers need ~0.5–1 s per period to follow overtakes.

## Install

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg`
- Codex: `npx skills add vargHQ/skills --skill varg-video-edit-library -a codex -y`
- Cursor: `npx skills add vargHQ/skills --skill varg-video-edit-library -a cursor -y`

## Example output

https://s3.varg.ai/how-to/previews/0860592b3fb2/take-ranked-bar-race.mp4 — The Bar Chart Race component rendered as installed (npx hyperframes add bar-chart-race), defaults only (credit: Rendered by varg · HyperFrames Bar Chart Race, https://hyperframes.heygen.com/catalog/blocks/bar-chart-race)

## More numbers & charts skills

- [Big Stat Count-Up](https://varg.ai/how-to/skills/big-stat-count-up.md): One huge number counts from zero to its value and lands, with a short label under it.
- [Odometer Digit Roll](https://varg.ai/how-to/skills/odometer-digit-roll.md): Each digit rolls on its own wheel to the target, places settling right to left like an odometer.
- [Bars Grow with Value Labels](https://varg.ai/how-to/skills/bars-grow-with-labels.md): Bars rise from the baseline in a staggered cascade with values riding their tops.
- [Line Draws with Riding Label](https://varg.ai/how-to/skills/line-draws-riding-label.md): A line draws itself left to right while the current value rides the pen tip, ending on a dot and big label.
- [Progress Ring Fills](https://varg.ai/how-to/skills/progress-ring-fills.md): A thin ring draws on to a percentage while the number in its center counts up in sync.
- [Before → After Metric](https://varg.ai/how-to/skills/before-after-metric.md): The old number shows, gets crossed or rolls, and the new better number takes its place.

## Run the generation on varg

varg is one API key for the models these skills drive — Seedance 2.5, Kling 4, Veo 3.1, Wan 3, Nano Banana 2.1, GPT Image 2.5, ElevenLabs v4 and 200+ more — billed in credits, with a cost estimate before anything runs.

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg` (skill + hosted MCP)
- Codex, Cursor, Gemini CLI, OpenClaw: `npx skills add vargHQ/skills --skill varg-ai -a <agent> -y`
- Grok and any agent that reads SKILL.md: `npx skills add vargHQ/skills --skill varg-ai`, or point it at the skill's SKILL.md
- Claude.ai, ChatGPT, any MCP client: connect `https://mcp.varg.ai/mcp`
- API key: https://varg.ai/dashboard/api · Model specs: https://varg.ai/models/llms.txt