github-stars
/github-stars
Show a GitHub repo's star growth as CLI charts — by day and by hour, in any timezone. Use when the user asks to "check GitHub stars", "stars by hour/day for <repo>", "star growth", "how many stars did <repo> get today", or shares a repo name and wants its starring activity over time.
- Author
- OpenClaudia ↗
- Repository
- openclaudia-skills ↗
- Licence
- MIT
- Last repository change
- 21.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: github-stars.sh
What it does and when to use it
Show a GitHub repo's star growth as CLI charts — by day and by hour, in any timezone. Use when the user asks to "check GitHub stars", "stars by hour/day for <repo>", "star growth", "how many stars did <repo> get today", or shares a repo name and wants its starring activity over time.
Triggers from the description
Original author description
Show a GitHub repo's star growth as CLI charts — by day and by hour, in any timezone. Use when the user asks to "check GitHub stars", "stars by hour/day for <repo>", "star growth", "how many stars did <repo> get today", or shares a repo name and wants its starring activity over time.
How it works
- Requirements
- How it works
- Usage
- Examples
- Sample output
- Caveats — surface these to the user when relevant
- Re-checking / live polling
SKILL.md preview
--- name: github-stars description: Show a GitHub repo's star growth as CLI charts — by day and by hour, in any timezone. Use when the user asks to "check GitHub stars", "stars by hour/day for <repo>", "star growth", "how many stars did <repo> get today", or shares a repo name and wants its starring activity over time. --- # github-stars Fetch a repo's per-star timestamps from the GitHub API and render two ASCII charts in the terminal: **stars by day** and **stars by hour** (for the most recent day(s)). Useful for tracking a launch, a Show HN / Product Hunt spike, or DevRel growth. ## Requirements - The [`gh` CLI](https://cli.github.com/) installed and authenticated (`gh auth status`). Unauthenticated calls hit a low rate limit and large repos fail mid-pagination. - Python 3.9+ (uses the stdlib `zoneinfo` for correct DST handling). ## How it works The script calls `gh api` with the `application/vnd.github.star+json` Accept header, which adds a `starred_at` timestamp to each stargazer. It paginates through all stargazers, converts each timestamp to the target timezone, and buckets them by day and by hour. ## Usage The script lives next to this file. From the skill directory: ```bash bash github-stars.sh <owner/repo | search-term> [--tz <IANA tz>] [--days N] [--hours-days N] ``` - **`<owner/repo>`** — exact repo (e.g. `facebook/react`). Skips the search. - **`<search-term>`** — a bare word (no `/`) is resolved to the top repo by stars. - **`--tz`** — IANA timezone for all buckets. Default `America/Los_Angeles`. Use e.g. `UTC`, `America/New_York`, `Asia/Shanghai`, `Europe/Berlin`. - **`--days N`** — how many recent days to show in the daily chart (default 14). - **`--hours-days N`** — how many recent days to break out hourly (default 2). ## Examples ```bash # default: last 14 days daily + last 2 days hourly bash github-stars.sh vercel/next.js # resolve a search term, show UTC bash github-stars.sh next.js --tz UTC # zoom in: only today hourly, 7-day daily window bash github-stars.sh facebook/react --days 7 --hours-days 1 ``` ## Sample output ``` owner/repo — 284 stars (with timestamps) newest: 2026-06-15 02:03 PM PDT | now: 2026-06-15 02:11 PM PDT STARS BY DAY (PDT) 2026-06-13 16 █████████ 2026-06-14 69 ████████████████████████████████████████ ← peak 2026-06-15 22 █████████████ STARS BY HOUR — 2026-06-15 (PDT) total 22 06:00 5 ██████████████████████████████ 07:00 2 ████████████ 14:00 2 ████████████ ``` ## Caveats — surface these to the user when relevant - **40,000-star cap:** GitHub only returns `starred_at` for the first 40k stargazers. Past that, the hourly/daily breakdown is incomplete (the script warns). The plain total stays accurate. - **Net, not gross:** the stargazer list reflects stars currently in place. Un-stars don't appear, so a flat total between two checks can hide +1/−1 churn. If the live `stargazers_count` disagrees with the timestamp count, an un-star happened. - **DST is handled** automatically via `zoneinfo` — don't hardcode UTC offsets. ## Re-checking / live polling Just run the script again — it re-fetches live each time. To watch a launch, re-run on an interval and report the delta; don't poll faster than every ~15 minutes (rate limits + politeness).
Files in this package (2)
- SKILL.md 3 KB
- github-stars.sh 3 KB
Versions
The database has no other skills named github-stars.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 93a7418478c7 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100github-star-manager
整理、分类、清理、备份与恢复 GitHub Stars,或批量评估导入新项目。当用户要求整理/分类/清理/备份 GitHub 收藏、管理 star 列表(List)、批量评估仓库,或提到「GitHub Stars 整理 / 清理收藏 / star 太多」时使用。支持 organize/import/backup 模式;凭证通过环境变量或 WorkBuddy 的 GitHub 连接器注入,无需在 Skill 目录内放置 .env。 - 100github-star-magnet
Turns any project idea into a GitHub repo designed to earn stars, real users and contributors, using patterns measured from the 491 most-starred GitHub repositories (12 repo archetypes, growth speed, naming, taglines, README structure, launch plan). Use this whenever the user… - 95github-elements
Install GitHub display components from the Elements registry. Use when user needs GitHub repo cards, profile cards, contribution calendars, star counters, language breakdowns, or activity displays. Triggers on "github component", "github card", "repo card", "contributions… - 100github-dashboard
GitHub repository analytics dashboard — stars, forks, contributors, issues, pull requests, recent activity, and top contributors. Use when the brief asks for a GitHub repo dashboard, open-source growth report, repository health page, or GitHub analytics view. - 90launch-plan
Build a day-by-day launch plan for an open-source repo that concentrates stars into one window to hit GitHub Trending. Use when the user wants to launch, asks how to get stars, asks which channels to post to, or asks for a schedule. - 100github-optimization
Optimize any GitHub repo for maximum stars, traffic, followers, and discoverability. Rewrites README as a high-converting landing page with SEO-optimized headers, shields.io badges, star/follow CTAs, keyword-rich description and topics, humanized copywriting, and author…