steipete/github-cache-hygiene

Higiene del caché/cuota de GitHub: gh, ghx, xcache, gitcrawl, mirrors, límites.

¿Qué es github-cache-hygiene?

Este skill optimiza el uso de la API de GitHub para agentes de IA como Claude Code, priorizando lecturas locales y en caché a través de `gitcrawl` y el shim `gh`, solo realizando llamadas en vivo cuando son estrictamente necesarias (escrituras, verificación de estado reciente). Es compatible con herramientas como `gh`, `ghx`, `xcache`, `gitcrawl` y flujos de trabajo de Actions. Su objetivo es reducir el consumo de cuota de API, acelerar las respuestas y evitar bucles ineficientes. Proporciona comandos concretos para sincronizar repositorios (`gitcrawl sync`), buscar issues/PRs localmente, inspeccionar el comportamiento del caché (`gh xcache stats`) y manejar la actualización de datos con estrategias de backoff y recuperación tras escrituras. También incluye pautas de etiqueta para agentes, como agrupar preguntas por repositorio y estado, reutilizar datos ya mostrados y no eludir el shim a menos que se esté diagnosticando un problema.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-cache-hygiene

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Higiene del Caché de GitHub

Objetivo: responder primero las preguntas comunes de lectura de GitHub desde gitcrawl y el shim gh, y gastar llamadas a la API de GitHub en vivo solo donde la frescura o las escrituras sean importantes.

Ruta Predeterminada

Usa gh de forma normal. En las máquinas de Peter, se espera que sea el shim respaldado por gitcrawl, por lo que las lecturas compatibles pueden responderse localmente o en caché sin cambiar los comandos.

Prefiere estas lecturas locales/en caché:

gitcrawl sync owner/repo --numbers 123 --with pr-details
gh search issues "<términos>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<términos>" -R owner/repo --state open --json number,title,state,url,updatedAt,isDraft,author
gh issue list -R owner/repo --state open --author usuario --assignee usuario --label bug --json number,title,url
gh pr list -R owner/repo --state open --author usuario --label dependencies --json number,title,url
gh issue view 123 -R owner/repo --json number,title,state,body,comments,labels,url
gh pr view 123 -R owner/repo --json number,title,state,body,comments,labels,files,commits,statusCheckRollup,url
gh pr checks 123 -R owner/repo --json name,state,detailsUrl,workflow
gh run list -R owner/repo --branch nombre-rama --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch

Usa referencias exactas y campos reducidos. Evita bucles amplios como un gh issue view por resultado cuando un solo gh search o gh issue list --json ... puede responder la pregunta inicial.

Para CI, evita bucles de sondeo intensivos con gh run list / gh run view. Después de un push o un workflow dispatch, identifica una ejecución exacta y luego sondea con backoff. Obtén los registros completos solo para trabajos fallidos o cuando el usuario los solicite explícitamente. Los registros de tipo completado (gh run view --log, --log-failed) y los endpoints REST comunes de Actions se almacenan en caché por más tiempo en gitcrawl, mientras que el estado de la ejecución permanece de corta duración.

Frescura

Las respuestas locales son buenas para descubrimiento, búsqueda de duplicados, revisión de hilos antiguos, triaje por autor/etiqueta y comprobaciones de "¿es probable que ya exista un issue/PR?".

Usa una llamada en vivo cuando:

  • escribas, comentes, cierres, fusiones, reejecuciones o ediciones
  • verifiques el estado final actual antes de una acción de mantenedor
  • verifiques el estado de CI después de un push
  • el resultado local falte o esté claramente desactualizado
  • el usuario solicite el estado más reciente/en vivo

Para revisión de PR, prefiere hidratar los detalles exactos del PR una vez con gitcrawl sync owner/repo --numbers <n> --with pr-details cuando sepas que inspeccionarás archivos, commits, comprobaciones o resúmenes de ejecución repetidamente. El shim gh puede auto-hidratar un PR exacto en caso de fallo, usando GITHUB_TOKEN o gh auth token; la hidratación explícita hace más claros la intención y el costo.

Después de una escritura, realiza una lectura de verificación dirigida, no un resaneo amplio.

XCache

Inspecciona el comportamiento del caché cuando se sospechen límites de tasa:

gh xcache stats
gh xcache keys
gh xcache gc

Lee backend_misses_by_command y backend_misses_by_route en gh xcache stats --json antes de agregar nuevos bucles en vivo de GitHub. Esos mapas muestran qué formas de comando aún están escapando del caché.

Usa gh xcache flush solo cuando una respuesta de respaldo en caché desactualizada esté generando una decisión engañosa.

Para una prueba solo local, haz que el backend no esté disponible temporalmente para un solo comando:

GITCRAWL_GH_PATH=/tmp/no-real-gh gh search issues "<términos>" -R owner/repo --json number,title,url

Etiqueta del Agente

Agrupa las preguntas por repositorio y estado. Reutiliza los datos ya mostrados en la sesión. Realiza backoff en el sondeo de CI; inspecciona los registros solo para ejecuciones fallidas o la ejecución exacta bajo revisión. No omitas el shim con /opt/homebrew/opt/gh/bin/gh a menos que estés diagnosticando el propio shim.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills relacionados