github-star-analyzer
오늘 수집한 GitHub Repository Star 데이터와 전날 Snapshot을 비교해 24시간 Star 증가량(delta24h), Total Stars TOP10, 24h Growth TOP10, 신규 발견 목록을 계산한다. 숫자 계산은 반드시 번들된 스크립트로 수행한다. github-ai-discovery 다음 단계에서 사용한다.
Resources
3Install
npx skillscat add sonic0506/ai-github-study-automation/github-star-analyzer Install via the SkillsCat registry.
SKILL.md
github-star-analyzer
결정적(deterministic) Skill. 모든 숫자는 scripts/analyze.mjs가 계산한다.
LLM이 Star 수를 직접 더하거나 빼거나 정렬하지 않는다.
입력 (AnalyzerInput)
{
"date": "2026-09-17",
"current": [ { "repository": "owner/name", "url": "...", "description": "...", "stars": 123 } ],
"previousSnapshot": { "version": 1, "date": "2026-09-16", "repositories": [ { "repository": "owner/name", "stars": 100 } ] },
"firstSeen": { "owner/name": "2026-09-01" },
"options": { "topN": 10, "growthMinDelta": 1 }
}current:github-ai-discovery출력의repositoriespreviousSnapshot: 오늘 이전의 가장 최근 Snapshot (전날이 없으면 며칠 전 것). 기록이 전혀 없으면nullfirstSeen(필수): Registry에 등록된 Repository → 최초 발견일. 첫 실행이면{}options: 생략 시resources/discovery.yml의ranking값과 동일한 기본값(10, 1)
실행
node scripts/analyze.mjs input.json > analysis.json출력 (AnalyzerOutput)
baseline:{ "date": "비교 기준일", "gapDays": 1 }또는null.gapDays가 2 이상이면 리포트에 "N일 전 대비"로 표시해야 한다repositories: RepositoryInfo[] (resources/schemas/repository.schema.json)rankings:totalStarsTop10,growth24hTop10,newlyDiscovered(resources/schemas/ranking.schema.json)snapshot: 오늘자 Snapshot (resources/schemas/snapshot.schema.json) — GitHub Actions가data/snapshots/{date}.json으로 저장
계산 규칙
| 상황 | 결과 |
|---|---|
| Registry에 없음 | isNew=true, firstSeen=오늘 → newlyDiscovered에 포함 |
| Registry에는 있지만 기준 Snapshot에 없음 | isNew=false, previousStars=null, delta24h=null |
| 전날 Snapshot 누락 | 가장 최근 Snapshot과 비교, baseline.gapDays로 기간 표시 |
| Star 변화 없음 / 감소 | delta24h는 0 / 음수. Growth TOP10에서는 제외 (growthMinDelta 미만) |
| 중복 Repository (대소문자 무시) | Star가 큰 관측값 1개만 유지 |
| 후보가 N개 미만 | 있는 만큼만 반환 |
| 동점 | Total: stars → 이름순 / Growth: delta → stars → 이름순 |
규칙
- 스크립트 출력 JSON을 수정하지 않고 다음 단계(
study-candidate-selector)로 전달한다. - 스크립트가 오류를 내면 입력을 고쳐 재실행하고, 숫자를 추정해서 채우지 않는다.
Categories
Install
npx skillscat add sonic0506/ai-github-study-automation/github-star-analyzer Install via the SkillsCat registry.