Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/basecamp/house-skills --skill github-activityAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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 |
