# Github Cache Hygiene

GitHub quota/cache hygiene: Gitcrawl archives, Octopool-backed gh, freshness, limits.

- Repository: https://github.com/steipete/agent-scripts (7431 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add steipete/agent-scripts --skill github-cache-hygiene -g -a claude-code -y`
Codex: `npx skills add steipete/agent-scripts --skill github-cache-hygiene -g -a codex -y`
Cursor: `npx skills add steipete/agent-scripts --skill github-cache-hygiene -g -a cursor -y`
Gemini CLI: `npx skills add steipete/agent-scripts --skill github-cache-hygiene -g -a gemini-cli -y`

## Description

GitHub quota/cache hygiene: Gitcrawl archives, Octopool-backed gh, freshness, limits.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GitHub Cache Hygiene

Goal: discover in the local Gitcrawl archive first, then use the existing Octopool-backed `gh` shim for current GitHub metadata and authorized writes.

## Default Path

Start with local archive reads:

```bash
gitcrawl search prs "<terms>" -R owner/repo --state open --json number,title,url
```

```bash
gitcrawl threads owner/repo --numbers 123 --include-closed --json
```

`--include-closed` keeps closed or merged candidates in scope. Archive state can lag GitHub; it is not proof of current state.

Then use bare PATH `gh` when current metadata is needed. On Peter's machines it is expected to be the Octopool-backed shim, so supported JSON reads share the fleet cache without changing authentication or command routing:

```bash
gh search issues "<terms>" -R owner/repo --state open --json number,title,state,url,updatedAt,labels,author
gh search prs "<terms>" -R owner/repo --state open --json number,title,state,url,updatedAt,isDraft,author
gh issue list -R owner/repo --state open --author user --assignee user --label bug --json number,title,url
gh pr list -R owner/repo --state open --author user --label dependencies --json number,title,url
gh issue view 123 -R owner/repo --json number,title,state,body,labels,url
gh pr view 123 -R owner/repo --json number,title,state,url,headRefName,headRefOid
gh pr checks 123 -R owner/repo --json name,state,bucket,link
gh run list -R owner/repo --branch branch-name --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch
```

The rest: https://github.com/steipete/agent-scripts/blob/HEAD/skills/github-cache-hygiene/SKILL.md