← Back to Skills Marketplace
coderyi

GitHub Trending Report

by coderyi · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
640
Downloads
1
Stars
4
Active Installs
3
Versions
Install in OpenClaw
/install github-trending-report
Description
Fetch and generate structured reports on fastest-growing repos, newly popular projects, and hot GitHub topic tags using github-discover CLI.
README (SKILL.md)

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-discover installed 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 trending growth score is estimated from creation time and star count, and it is not GitHub's official Trending page data
  • The -l language filter matches only the repository's primary language; multi-language projects may be excluded
Usage Guidance
This skill is coherent: it instructs use of the github-discover CLI to produce reports. Before installing or using it, verify the npm package: check the github-discover package page (npm view github-discover repository, homepage, and maintainers), review its source code/repository, and confirm it is from a trusted author. Be aware that global npm installs run third‑party code on your system — consider installing in a container or VM if you want isolation. Also note the SKILL.md does not mention GitHub auth or rate limits; if you plan frequent queries, set up a GITHUB_TOKEN and check the CLI docs for how to configure it. If you need higher confidence, provide the github-discover package repository or a homepage URL so provenance can be verified.
Capability Analysis
Type: OpenClaw Skill Name: github-trending-report Version: 1.0.2 The skill bundle provides a structured workflow for an AI agent to generate GitHub trending reports using a legitimate-appearing CLI tool, 'github-discover'. The instructions in SKILL.md are task-oriented, focusing on data retrieval and report formatting without any evidence of data exfiltration, malicious command execution, or prompt injection intended to hijack the agent's behavior.
Capability Assessment
Purpose & Capability
The name/description match the runtime instructions: the SKILL.md tells the agent to call the github-discover CLI to produce trending, popular, and topic reports. Requiring Node.js and an npm-installed CLI is reasonable for this purpose.
Instruction Scope
Instructions limit the agent to checking for the CLI, running three github-discover commands, and combining their JSON outputs into a report — all within the stated purpose. The doc does not mention GitHub authentication or rate limits (e.g., GITHUB_TOKEN) which may be required for heavier use; that omission may cause failures or unexpected network behavior but is not itself incoherent.
Install Mechanism
This is an instruction-only skill (no install spec in registry), but SKILL.md instructs the user to run `npm install -g github-discover`. Installing a global npm package executes code from the npm registry — a normal choice but a moderate operational risk if the package provenance is unknown. The skill itself does not perform any installs automatically.
Credentials
The registry declares no required env vars or credentials, which aligns with the high-level description. However, the CLI likely calls the GitHub Search API; for larger workloads or to avoid low unauthenticated rate limits the CLI or API calls may require or benefit from a GITHUB_TOKEN. The SKILL.md does not document this or any credential-related env vars.
Persistence & Privilege
The skill does not request persistent presence (always:false), does not declare any config paths, and does not attempt to modify agent/system settings. It is user-invocable only, which is appropriate for a report-generating CLI wrapper.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-trending-report
  3. After installation, invoke the skill by name or use /github-trending-report
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Removed the requirement for the `GITHUB_TOKEN` environment variable in the prerequisites section. - No changes to features or workflow; documentation updated for improved clarity on prerequisites.
v1.0.1
- Updated Limitations section to clarify that the `trending` score is estimated and not official GitHub Trending data. - Removed mention of API rate-limiting behavior and GITHUB_TOKEN from the Limitations section. - No changes were made to the skill logic or commands; documentation only.
v1.0.0
Initial release of GitHub Trending Report skill. - Provides structured GitHub trending reports using `github-discover` CLI. - Supports fetching fastest-growing repositories, newly popular projects, and trending topic tags. - Step-by-step workflow included for fetching, filtering, and combining data. - Output is organized into Fastest-Growing Projects, Newly Popular Repositories, Hot Topics, and AI Insights sections. - Includes installation instructions, usage details, and current feature limitations.
Metadata
Slug github-trending-report
Version 1.0.2
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 3
Frequently Asked Questions

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.

💬 Comments