repo-pulse

type	Skill
name	repo-pulse
category	dev
description	Report on new stars, forks, and releases for watched repos — with profile enrichment (name, location, company, bio, follower count) for every new stargazer and forker, plus a one-line growth verdict
var
tags	["dev"]
mode	write
commits	false
permissions	[]

${var} — Repo (owner/repo) to check. If empty, checks all watched repos.

Config

Reads repos from memory/watched-repos.md. Skip any repo whose name ends with -aeon or contains aeon-agent — those are agent repos, not project repos.

If ${var} is set and matches owner/repo, check only that repo.

Context

Read memory/MEMORY.md and the last 4 weeks of memory/logs/ for previous stargazers_count / forks_count per repo. Parse lines matching **owner/repo**: stargazers_count=N, forks_count=M to reconstruct a per-run series — you'll need it for the weekly-baseline (avg4w) used in step 5. Runs are weekly, so expect roughly one datapoint per week; if the logs still hold denser daily entries from the old schedule, take the newest entry in each 7-day bucket rather than mixing cadences.

Steps

1. Compute the 7-day cutoff FIRST

CUTOFF=$(date -u -d '7 days ago' +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)
export CUTOFF

All time filtering uses exactly this timestamp — never "today's date" or "since midnight".

2. Fetch current counts (1 call per repo)

gh api repos/owner/repo --jq '{stargazers_count, forks_count, subscribers_count}'

If this call returns non-2xx (404, 403, rate limit), record source=fail with the reason and continue to the next repo. Do not abort the batch.

3. Fetch recent events — primary input

One call per repo covers stargazers, forks, and releases for the last ~90 days, newest-first:

gh api --paginate "repos/owner/repo/events?per_page=100" \
  --jq '[.[] | select(.created_at >= env.CUTOFF) | {type, actor: .actor.login, created_at, tag: (.payload.release.tag_name // null), action: (.payload.action // null)}]'

Paginate — a single 100-event page covers ~24h on an active repo but can truncate a 7-day window. Use --paginate and stop early once you see an event older than (events are newest-first). If the oldest event you retrieved is still than , the window is truncated: record for that repo and say so in the report — never present a truncated count as complete.