star-milestone

Detect GitHub repository star-count milestone crossings and generate velocity-based announcements.

626|225|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon --skill star-milestone-aaronjmars
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: star-milestone
Source: https://github.com/aaronjmars/aeon/tree/main/skills/star-milestone
Command: npx skills add https://github.com/aaronjmars/aeon --skill star-milestone-aaronjmars

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh api, and includes assets (resource) components.

What problem does it solve?

It turns raw GitHub star-count changes into meaningful milestone updates by adding velocity, trajectory shape, and highlights so readers learn why growth happened and what’s next.

Core Features & Use Cases

  • Detect milestone crossings: Watches one repo (or a configured watchlist) and triggers only when a higher star threshold is crossed.
  • Add velocity-shaped context: Computes recent star velocity (v7, v30), baseline pace, days to milestone, and a trajectory label (e.g., SPIKE, ORGANIC, TRICKLE).
  • Anti-spam and trust safeguards: Suppresses notifications for bootstrap/stale/deferred scenarios and flags suspected fake-star bursts for manual review.
  • Highlight reel from recent activity: Extracts 1–3 concrete, shipped-value highlights from recent logs (or falls back to recent commit messages) for a tight narrative.
  • Stateful tracking: Records milestones in memory so the same milestone is never announced twice.

Quick Start

Run star-milestone for owner/repo by setting var to owner/repo and letting it notify the configured channels when a milestone threshold is crossed.

Frequently Asked Questions about star-milestone

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub star milestone notifications for my repository?

Automate GitHub star milestone notifications by configuring a watchlist of target repositories and running daily monitoring to trigger alerts when star-count thresholds are crossed. The system fetches stargazer counts and timestamps to detect milestone crossings and posts updates to configured Telegram channels.

What is GitHub star velocity analytics and how does it measure repo growth?

GitHub star velocity analytics measures repository growth momentum by computing recent star velocity over 7-day and 30-day windows, comparing against a baseline pace, and assigning a trajectory label like SPIKE, ORGANIC, or TRICKLE to characterize the growth pattern.

Do I need the gh api CLI to monitor repository stargazer counts?

Yes, you need the gh api CLI to monitor repository stargazer counts. The Skill depends on the GitHub API command-line tool to fetch stargazer counts and timestamps for computing velocity metrics and detecting threshold crossings.

Can I track multiple GitHub repositories for star growth milestones at once?

Yes, you can track multiple GitHub repositories for star growth milestones by supplying a configured watchlist. Alternatively, you can set a variable to a single owner/repo string to monitor one repository.

How are fake star bursts detected during repository milestone monitoring?

Fake star bursts are detected during repository milestone monitoring by flagging suspected artificial inflation bursts for manual review. The system gates notifications with stale and suspected fake-star logic to suppress alerts for bootstrap, stale, or deferred scenarios.

Why does my GitHub star milestone announcement include recent commit messages?

GitHub star milestone announcements include recent commit messages as a fallback to construct a highlight reel. The system extracts 1–3 concrete shipped-value highlights from recent activity logs to provide narrative context for the growth.