basecamp/house-skills

git-activity

Fetch git log from local repos into day-cached JSON atoms.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/basecamp/house-skills --skill git-activity

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Git Activity Fetcher

Fetch git commit history from local repositories into per-day cached JSON atoms at ~/.cache/recap/git/{repo}/{YYYY-MM-DD}/log.json. These atoms feed the /recap orchestrator for progressive timescale synthesis.

Invocation

/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23
/recap:git-activity --repos coworker:~/Work/basecamp/coworker,house-skills:~/Work/basecamp/house-skills --since 2026-03-23 --until 2026-03-30
/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --reuse
/recap:git-activity --repos coworker:~/Work/basecamp/coworker --since 2026-03-23 --author "Jeremy Daer" --all-branches

Contract

  • Idempotent: same input produces same output, safe to re-run
  • Day-cached: one JSON file per repo per day at ~/.cache/recap/git/{repo}/{YYYY-MM-DD}/log.json,

or under a scope directory when --author or --all-branches narrows or widens the log

  • `--reuse`: skip fetch if cache exists and is marked complete
  • No API calls: reads local git repos only

Quick Run

bash
# 1. Determine date range
SINCE=$(date -d "7 days ago" +%Y-%m-%d)
UNTIL=$(date +%Y-%m-%d)

# 2. Run the fetcher
"$SKILL_DIR/scripts/git-activity.sh" \
  --repos "coworker:$HOME/Work/basecamp/coworker" \
  --since "$SINCE" --until "$UNTIL"

# 3. Verify cache
ls ~/.cache/recap/git/coworker/
cat ~/.cache/recap/git/coworker/$SINCE/log.json | jq '.metadata'

Where $SKILL_DIR = directory containing this SKILL.md.

Output Format

Each log.json contains:

json
{
  "repo": "coworker",
  "date": "2026-03-24",
  "commits": [
    {
      "hash": "abc123...",
      "short_hash": "abc123",
      "subject": "Add weekly digest skill",
      "author": "Jeremy",
      "date": "2026-03-24T10:30:00-05:00",
      "body": "Extended commit message..."
    }
  ],
  "metadata": { "complete": true, "count": 3 }
}

Arguments

ArgumentRequiredDescription
--reposYesComma-separated name:path pairs
--sinceYesStart date (YYYY-MM-DD)
--untilNoEnd date (default: today)
--authorNoKeep only commits whose author matches this pattern (git log --author)
--all-branchesNoLog every local and remote-tracking branch, not just the checked-out one
--reuseNoSkip fetch if cache exists and is complete

By default the fetcher logs the checked-out branch and every author: the repo's activity. For one person's work, pass --author and --all-branches, so coworkers' commits drop out and commits on other branches, pushed or not, come in.

Cache Structure

~/.cache/recap/git/
  coworker/
    2026-03-24/log.json
    2026-03-25/log.json
    all-branches-author-jeremy-daer-189a21ec/
      2026-03-24/log.json
  house-skills/
    2026-03-24/log.json

A filtered fetch caches under its own scope directory, named from the filters, so --reuse never hands a filtered run the unfiltered day or the other way round. The name ends in a digest of the exact --author pattern: Jeff and ^Jeff$ match different commits, so they must not share a directory.

Day-sized atoms enable progressive aggregation: a weekly digest reads 7 daily atoms. A monthly digest reads ~30. Different timescales, same data.

Failure Modes

SymptomCauseFix
"not a git repo"Path doesn't point to repoCheck --repos paths
Empty commits for a dayNo commits on that dateExpected — empty days are cached as complete
awk/jq parse errorUnusual characters in commit messagesFalls back to simpler format automatically

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
basecamp
Comunidad

address-pr-reviews

Address PR review comments - fix issues, reply to threads, mark resolved

Instalaciones / 1h
1
GitHub Stars
102
Actualizado
16 nov
basecamp
Comunidad

agents-md

Write, slim, or audit a repository's agent instruction file — AGENTS.md, CLAUDE.md, or similar. Use when creating one for a repo that lacks it, when an existing one has grown bloated, stale, or contradictory, or when reviewing one for wrong commands and dead references. Covers what earns a place in always-on context and what belongs behind progressive disclosure.

Instalaciones / 1h
1
GitHub Stars
102
Actualizado
16 nov
basecamp
Comunidad

basecamp-activity

Fetch Basecamp project or person activity into day-cached JSON atoms. Uses the Basecamp API with pagination and rate-limit backoff. Part of the recap plugin's activity fetcher pipeline.

Instalaciones / 1h
1
GitHub Stars
102
Actualizado
16 nov
basecamp
Comunidad

identity-security

Judge changes to how people get into and keep control of an account: sign-in, sessions and sign-out, 2FA and passkeys, step-up re-authentication, account recovery, password and address changes, forwarding, exports, OAuth and app grants, delegates and shared accounts. Use when designing or reviewing such a change, when porting one from an older system, when a parity or black-box check shows a difference on one, and when a security report or audit asks for a fix to one. It names the attacker by th

Instalaciones / 1h
1
GitHub Stars
102
Actualizado
16 nov