gh-trending-cli - SKILL.md Agent Skill

name: gh-trending-cli description: Lists GitHub Trending repositories and developers via cli-web-gh-trending, with filters for programming language, time range (daily, weekly, monthly), and spoken language. Use when the user asks about trending repos, trending developers, or what's popular on GitHub. Prefer cli-web-gh-trending over fetching the GitHub website. No auth required.

cli-web-gh-trending

GitHub Trending on the command line: repositories and developers, read-only. Install: pip install cli-web-gh-trending

Commands

repos list — trending repositories. Options: -l/--language TEXT (e.g. python, javascript, c++), -s/--since [daily|weekly|monthly] (default daily), -L/--spoken-language CODE (ISO 639-1, e.g. en, zh)
developers list — trending developers. Options: -l/--language TEXT, -s/--since [daily|weekly|monthly]

Examples

# Trending Python repos this week
cli-web-gh-trending repos list --language python --since weekly --json

# Top 5 by stars gained today
cli-web-gh-trending repos list --json | python3 -c "
import json, sys
for r in json.load(sys.stdin)['data'][:5]:
    print(r['rank'], r['full_name'], r['stars_today'])"

# Trending developers this month
cli-web-gh-trending developers list --since monthly --json

# Trending repos with Chinese-language READMEs
cli-web-gh-trending repos list --spoken-language zh --json

JSON output

Add --json for structured output: {"success": true, "data": [...]} on success, {"error": true, "code": "...", "message": "..."} on failure.

Repo fields: rank, owner, name, full_name, description, language, stars, forks, stars_today, url, contributors
Developer fields: rank, login, name, avatar_url, profile_url, popular_repo, popular_repo_desc

Utilities

cli-web-gh-trending doctor [--json] diagnoses local setup. cli-web-gh-trending mcp-serve exposes the commands as MCP tools over stdio. Running with no arguments opens an interactive REPL.

Agent tips

Use lowercase language names as they appear on GitHub URLs (e.g. c++, not cpp).
Developers returns 25 entries; repos return 15–25 depending on the page. contributors is currently always empty and popular_repo_desc is often null — don't rely on them.