/install github-trending-report
GitHub Trending Report
Use the github-discover CLI to fetch real-time GitHub data and generate structured trending reports — discover fast-rising repositories, newly popular projects, and hot topic tags.
Installation
npm install -g github-discover
Requires Node.js 18+. Check with
node --version.
Prerequisites
- Node.js ≥ 18
github-discoverinstalled globally (see Installation above)
Commands
trending — Fastest-growing repositories
Ranked by daily average stars with a 30-day smoothing factor, removing age bias to surface genuinely fast-rising projects.
github-discover trending [options]
| Option | Description | Default |
|---|---|---|
-p |
Period: daily / weekly / monthly / yearly | daily |
-n |
Number of results (1–100) | 50 |
-l |
Filter by programming language (e.g. python, typescript) | all |
-s |
Minimum star threshold | auto by period |
--json |
Output as JSON | — |
popular — New high-star repositories
Sorted by raw star count descending, focused on recently created high-popularity projects.
github-discover popular [options]
Same options as trending.
topic — Hot topic tags
Scored by repoCount × log10(starSum) to surface trending technology topics.
github-discover topic [options]
| Option | Description | Default |
|---|---|---|
-p |
Period: daily / weekly / monthly / yearly | daily |
-n |
Number of results (1–100) | 30 |
--json |
Output as JSON | — |
Data Windows (trending command)
| Period | Repository creation range |
|---|---|
| daily | Created within last 7 days |
| weekly | Created within last 28 days |
| monthly | Created within last 90 days |
| yearly | Created within last 730 days |
Standard Workflow for Generating a Report
When a user requests a GitHub trending report, follow these steps:
Step 1: Verify the tool is available
github-discover --version
If the command is not found, prompt the user to run npm install -g github-discover, then stop.
Step 2: Determine the time period
Infer the period from the user's request:
- "today" / "latest" / "right now" →
daily - "this week" / "weekly" →
weekly - "this month" / "monthly" →
monthly - "this year" / "annual" →
yearly - Not specified → default to
daily
Step 3: Fetch all three data sets in parallel
github-discover trending -p \x3Cperiod> -n 10 --json
github-discover popular -p \x3Cperiod> -n 10 --json
github-discover topic -p \x3Cperiod> -n 10 --json
If the user specified a language (e.g. Python, TypeScript), append -l \x3Clanguage> to the trending and popular commands.
Step 4: Generate the structured report
Combine the JSON output from all three commands and produce a report in the following format:
📈 GitHub \x3CPeriod> Trending Report
1. Fastest-Growing Projects
Source:
trending— reflects real growth velocity, age bias removed
List Top 5–10 entries, each with:
- Repository name (with link)
- Short description
- Star count / daily average growth
- Primary language
2. Newly Popular Repositories
Source:
popular— recently created projects gaining rapid traction
List Top 5–10 entries, same format as above.
3. Hot Topics
Source:
topic— scored by repository count × star magnitude
List Top 10 topic tags with a brief description of each technology area.
4. AI Insights
Based on the data above, provide:
- A 2–3 sentence summary of the key technical trends this period
- Projects or movements worth watching closely
- If a language filter was applied, a brief analysis of that ecosystem's current state
Limitations
- Data is sourced from the GitHub Search API; freshness depends on GitHub's indexing lag
- The
trendinggrowth score is estimated from creation time and star count, and it is not GitHub's official Trending page data - The
-llanguage filter matches only the repository's primary language; multi-language projects may be excluded
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-trending-report - After installation, invoke the skill by name or use
/github-trending-report - Provide required inputs per the skill's parameter spec and get structured output
What is GitHub Trending Report?
Fetch and generate structured reports on fastest-growing repos, newly popular projects, and hot GitHub topic tags using github-discover CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 640 downloads so far.
How do I install GitHub Trending Report?
Run "/install github-trending-report" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Trending Report free?
Yes, GitHub Trending Report is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does GitHub Trending Report support?
GitHub Trending Report is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Trending Report?
It is built and maintained by coderyi (@coderyi); the current version is v1.0.2.