Verwendung
- Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
- Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
- Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/basecamp/house-skills --skill github-activityVor dem Start
- Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
- Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument
Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.
GitHub Activity Fetcher
Fetch GitHub activity — PRs authored, PRs reviewed, issues created, commit contributions — into per-day cached JSON atoms at ~/.cache/recap/github/{user}/{YYYY-MM-DD}/activity.json.
Invocation
/recap:github-activity --since 2026-03-23
/recap:github-activity --since 2026-03-23 --until 2026-03-30
/recap:github-activity --user jeremy --org basecamp --since 2026-03-23 --reuseContract
- Idempotent: same input produces same output, safe to re-run
- Day-cached: one JSON file per user per day
- `--reuse`: skip fetch if cache exists and is marked complete
- Rate-limit aware: uses
gh api --paginatewith built-in backoff
Quick Run
bash
# 1. Validate auth
gh auth status || { echo "Run: gh auth login"; exit 1; }
# 2. Determine date range
SINCE=$(date -d "7 days ago" +%Y-%m-%d)
UNTIL=$(date +%Y-%m-%d)
# 3. Run the fetcher
"$SKILL_DIR/scripts/github-activity.sh" --since "$SINCE" --until "$UNTIL"
# 4. Verify cache
USER=$(gh api user --jq '.login')
ls ~/.cache/recap/github/$USER/
cat ~/.cache/recap/github/$USER/$SINCE/activity.json | jq '.metadata'Where $SKILL_DIR = directory containing this SKILL.md.
Output Format
Each activity.json contains:
json
{
"user": "jeremy",
"date": "2026-03-24",
"prs_authored": [
{
"title": "Add weekly digest skill",
"html_url": "https://github.com/basecamp/coworker/pull/99",
"created_at": "2026-03-24T14:30:00Z",
"repository_url": "https://api.github.com/repos/basecamp/coworker",
"state": "closed",
"pull_request": { "merged_at": "2026-03-24T15:00:00Z" }
}
],
"prs_reviewed": [],
"issues": [],
"metadata": {
"complete": true,
"counts": { "prs_authored": 1, "prs_reviewed": 0, "issues": 0 }
}
}Commit contributions are cached separately as an aggregate at ~/.cache/recap/github/{user}/commits-{since}-{until}.json since GitHub's GraphQL API returns them as a period summary, not per-day.
Arguments
| Argument | Required | Description |
|---|---|---|
--since | Yes | Start date (YYYY-MM-DD) |
--until | No | End date (default: today) |
--user | No | GitHub username (default: authenticated user) |
--org | No | Filter to a specific GitHub org |
--reuse | No | Skip fetch if cache exists and is complete |
Cache Structure
~/.cache/recap/github/
jeremy/
2026-03-24/activity.json
2026-03-25/activity.json
commits-2026-03-23-2026-03-30.jsonPrerequisites
ghCLI installed and authenticated (gh auth login)jqfor JSON parsing
Failure Modes
| Symptom | Cause | Fix |
|---|---|---|
| "gh: not logged in" | Token expired | gh auth login |
| Empty results | No activity in range | Expected — empty days cached as complete |
| Rate limit (403) | Too many API calls | Wait ~1hr and retry |
| >1000 PRs | Search API limit | Narrow date range or add --org filter |
