milestone-tracker

Track weekly progress on product and growth milestones via GitHub star counts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents teams from losing momentum on key product and growth milestones by making progress measurable, visible, and automatically alerting when targets are crossed, nearly reached, or stalled.

Core Features & Use Cases

  • Milestone config + persistent memory: Reads milestone targets from memory/milestones.md (auto-creates a seed file if missing) and updates the table after each run.
  • Automated signal sources: Tracks GitHub star counts for specific repos and counts enabled skills from aeon.yml, while supporting operator-managed manual milestones.
  • Stall detection and notifications: Classifies each milestone as crossed, done, approaching, stalled, or on-track, then sends notifications only when something notable happens.
  • Scheduling-friendly weekly operation: Logs results to memory/logs/${today}.md and writes notification payloads for the notify tool to deliver.

Quick Start

Run the milestone-tracker skill once per week so it updates memory/milestones.md from GitHub repo stars and enabled skills, then sends alerts for crossed, approaching, or stalled milestones.

Frequently Asked Questions about milestone-tracker

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

FAQPage Schema
How do I automate weekly milestone tracking for GitHub repositories?

To automate weekly milestone tracking, this skill reads targets from memory/milestones.md, pulls GitHub star counts via the gh CLI, and updates the file after each run. It classifies progress as crossed, approaching, stalled, or on-track.

What is stall detection in growth tracking and how does it work?

Stall detection in growth tracking identifies milestones lacking progress by evaluating thresholds and stall streaks from persistent memory. It then conditionally generates a notification payload for delivery when targets are stalled.

Can I track enabled skill counts alongside manual operator targets?

Yes, you can track enabled skill counts alongside manual operator targets. The skill reads enabled skills from aeon.yml while supporting operator-managed manual milestones, consolidating everything into the memory/milestones.md file.

How do I generate automated progress notifications without approval loops?

Automated progress notifications without approval loops are generated by writing conditional payloads for the ./notify tool to deliver. Notifications trigger only when milestones are crossed, approaching, or stalled.

Do I need to manually create the milestones.md file before tracking growth?

No, you do not need to manually create the milestones.md file. The skill automatically creates a seed file in the memory directory if the file is missing during its initial run.

What are the limitations of using persistent memory files for weekly reporting?

Limitations of using persistent memory files for weekly reporting include reliance on local markdown state management and requiring the gh CLI for GitHub API access. Operations are scheduling-friendly but depend on file system persistence.