How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/basecamp/house-skills --skill github-activityBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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 |
