Menu
GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/steipete/agent-scripts --skill github-cache-hygieneThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | github-cache-hygiene |
| description | GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits. |
Goal: answer common GitHub read questions from gitcrawl and the gh shim first, then spend live GitHub API calls only where freshness or writes matter.
Use gh normally. On Peter's machines it is expected to be the Octopool-backed shim, so supported reads share the fleet cache without changing commands.
Prefer these local/cached reads:
gitcrawl sync owner/repo --numbers 123 --with pr-details
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,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 branch-name --json databaseId,workflowName,status,conclusion,url
gh pr diff 123 -R owner/repo --patch
Use exact refs and narrow fields. Avoid broad loops like one gh issue view per result when a single gh search or gh issue list --json ... can answer the first-pass question.
For CI, avoid tight gh run list / gh run view polling loops. After a push or workflow dispatch, identify one exact run, then poll that run at 30s, 60s, then 120s intervals. Fetch logs once, only after failure or explicit request. Reuse prior output instead of re-reading completed runs.
Local answers are good for discovery, duplicate search, old thread review, author/label triage, and "is there likely already an issue/PR?" checks.
Use a live call when:
For PR review, prefer hydrating exact PR details once with gitcrawl sync owner/repo --numbers <n> --with pr-details when you know you will inspect files, commits, checks, or run summaries repeatedly. The gh shim can auto-hydrate one exact PR on miss, using GITHUB_TOKEN or gh auth token; explicit hydration makes intent and cost clearer.
After a write, do one targeted readback, not a broad rescan.
Inspect cache behavior when rate limits are suspected:
octopool whoami
octopool health
octopool stats --since 1h
octopool stats --since 24h --json
Check the saved-vs-backend totals, eligible hit rate, top route kinds, fallbacks, and client attribution. A missing client or unexpected server means that machine is outside the shared fleet cache.
Use OCTOPOOL_NO_FALLBACK=1 only for a bounded read probe that must prove relay coverage. Do not set it globally; mutations and unsupported reads still need real gh.
For relay-only proof:
OCTOPOOL_NO_FALLBACK=1 gh api repos/owner/repo --jq .full_name
Batch questions by repo and state. Reuse data already printed in the session. Back off CI polling; inspect logs only once for a failed run. For reads, never bypass the shim with an absolute real-gh path such as /opt/homebrew/bin/gh or /opt/homebrew/opt/gh/bin/gh unless diagnosing the shim itself. Reserve OPENCLAW_GH_BIN and plain gh resolution for repo workflows that need mutations; keep ordinary reads on bare gh.
Control the user's existing signed-in Chrome: callable Codex Chrome plugin first, then OpenClaw extension-backed mcporter, with direct DevTools attachment only as a last fallback.
REQUIRED before ANY `op` command or whenever a task needs an API key, token, password, credential, or secret (OPENAI_API_KEY, ANTHROPIC_API_KEY, deploy tokens, live-test keys). Prompt-free 1Password service-account reads; wrong invocations spam macOS dialogs.
yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.