chore: import upstream snapshot with attribution

2026-07-13 13:10:45 +08:00
commit 4b6817381b
3933 changed files with 525247 additions and 0 deletions
@@ -0,0 +1,61 @@
+---
+name: github-star-velocity
+description: Compute GitHub repository star velocity over a rolling time window using the stargazers API.
+tools:
+  - execute_python_code
+---
+
+# GitHub Star Velocity
+
+Use this skill when the user asks for GitHub star velocity, stars gained in the
+last N hours, star growth rate, or similar metrics for a repository.
+
+## Prerequisites
+
+1. Set `allow_network: true` on `execute_python_code`.
+2. Read `GITHUB_TOKEN` from the subprocess environment (injected when GitHub
+   credentials are configured). Never print the token.
+3. Parse `owner/repo` from the repository URL or user input.
+
+## API approach
+
+1. Fetch current `stargazers_count` from `GET /repos/{owner}/{repo}`.
+2. Fetch stargazers with timestamps from
+   `GET /repos/{owner}/{repo}/stargazers?per_page=100` using
+   `Accept: application/vnd.github.v3.star+json`.
+3. Each entry includes `starred_at`. Count stars where `starred_at` is within
+   the requested window (for example, the last 24 hours).
+
+## Critical pagination trap
+
+Stargazers are returned **oldest first**, not newest first. Do **not** stop
+after the first page when the newest entries on that page fall outside the
+window — that produces a false zero.
+
+Instead, paginate through **all** pages (follow the `Link` response header
+until there is no `rel="next"`) and count every `starred_at` inside the window.
+
+## Sanity check before reporting
+
+Treat these results as suspicious and rerun with a full paginated scan before
+answering:
+
+- `0` stars in the last 24 hours for a repo with thousands of stars and recent
+  activity
+- Velocity that implies losing stars without an explicit unstar request
+- Counts that disagree sharply with `stargazers_count` deltas when you have a
+  recent baseline
+
+When a result looks wrong, widen the scan (all pages), print the most recent
+`starred_at` observed, and only then return the velocity.
+
+## Output shape
+
+Return:
+
+- Total current stars
+- Stars gained in the window
+- Velocity (stars per hour and stars per day)
+- Window start timestamp (UTC)
+- Most recent `starred_at` in the window
+- Optional hourly breakdown for the last 24 hours