CtrlK
BlogDocsLog inGet started
Tessl Logo

github-cache-hygiene

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

54

Quality

60%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/github-cache-hygiene/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a dense, highly actionable policy document: nearly every instruction is an exact, copy-paste-ready command with specific flags, field lists, and timing rules, and the read/write/freshness workflow is well sequenced with several explicit checkpoints. Its weaknesses are structural rather than substantive — version-sensitive Octopool routing details and metrics-interpretation guidance are inlined in a single 125-line file instead of being split into reference files, and some dense passages could be tightened.

Suggestions

Move the Octopool 0.7.1 field-routing quirks and the cache-metrics interpretation (eligible responses, route/client mix, NO_FALLBACK semantics) into a references/ file, keeping SKILL.md as a lean overview with clearly signaled links.

Place version-specific notes in an 'old patterns' or 'deprecated' section (the retired `gitcrawl gh` note is a good model) so time-sensitive details don't clutter the main path.

Tighten the multi-clause prose runs (e.g. the mergeStateStatus/comments paragraph and the proof-by-relay paragraph) into short bullet rules so each constraint is scannable.

DimensionReasoningScore

Conciseness

The body is compact and free of beginner-concept padding, but several dense prose runs (e.g. the Octopool 0.7.1 field-bundle routing passage and the cached-eligible-response metrics paragraph) could be tightened, and the inline version number 'In Octopool 0.7.1' is time-sensitive information not placed in a deprecated/old-patterns section, which the guidelines say should penalize conciseness. This fits the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor; score 4 would require trimming these passages or moving version-specific quirks aside.

3 / 5

Actionability

The guidance is fully executable: exact commands with precise flags and field lists ('gh search prs "<terms>" -R owner/repo --state open --json number,title,state,url,updatedAt,isDraft,author', 'gitcrawl sync owner/repo --numbers 123 --with pr-details', 'OCTOPOOL_NO_FALLBACK=1 gh api repos/owner/repo --jq .full_name', 'octopool stats --since 24h --json'), plus concrete backoff intervals (30s/60s/120s) for CI polling. Copy-paste ready commands cover the common discovery, readback, and diagnostics cases, matching the top anchor.

5 / 5

Workflow Clarity

The default path is clearly sequenced — local Gitcrawl archive first, then bare gh for current metadata, then freshness rules for when to go live — with several explicit checkpoints: 'After a write, do one targeted fresh readback', 'Check the expected head SHA and run attempt', and 'checking final current state before a maintainer action'. It falls short of the score-5 anchor because the merge/write path lacks an explicit validate-before-proceed feedback loop (gates are referenced only as things not to remove), leaving minor validation gaps.

4 / 5

Progressive Disclosure

The body is well-sectioned (Default Path, Freshness, Octopool, Agent Etiquette) with no nested references, but at ~125 lines it exceeds the under-50-line simple-skill exception, and all content lives in SKILL.md with no bundle files — version-specific Octopool quirks and cache-metrics interpretation could be split into a reference file. 'Some structure but could be better organized' with inline content that could be separated fits the score-3 anchor; score 4 would require the Octopool diagnostics detail moved out or clearly partitioned.

3 / 5

Total

15

/

20

Passed

Description

48%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and distinctive thanks to named internal tooling (Gitcrawl, Octopool), but it reads as a topic label rather than a capability + trigger statement. It lists what the skill touches but neither what it does nor when to reach for it, capping completeness at 3 and leaving specificity at 2.

Suggestions

Add an explicit trigger clause, e.g. 'Use when GitHub rate limits, quota pressure, or stale cache results affect gh commands, issue/PR lookups, or CI checks.'

Convert the noun inventory into 2-3 concrete actions, e.g. 'Searches local Gitcrawl archives before live gh calls, routes gh reads through the Octopool fleet cache, and diagnoses cache/rate-limit health.'

Include the natural synonyms users would actually say — 'rate limit', 'API quota', 'stale results', 'GitHub CLI' — alongside the tool names.

DimensionReasoningScore

Specificity

The description names the domain ('GitHub quota/cache hygiene') and lists components ('Gitcrawl archives, Octopool-backed gh, freshness, limits'), but contains no verbs or concrete actions — it is a noun-phrase inventory, not a capability statement. It matches the 'names the domain but actions are minimal or generic' anchor; score 3 would require 1-2 named actions like 'searches local archives' or 'routes gh reads through the fleet cache', which are absent.

2 / 5

Completeness

The 'what' is present but compressed into a label ('GitHub quota/cache hygiene' plus a component list), and there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Score 4 would require an explicit 'when' clause such as 'Use when GitHub rate limits or stale caches affect gh or repo lookups'.

3 / 5

Trigger Term Quality

It includes distinctive natural terms users in this environment would say — 'GitHub', 'gh', 'cache', 'quota', 'Gitcrawl', 'Octopool' — but misses common variations like 'rate limit', 'API quota', 'GitHub CLI', or 'stale cache'. Some relevant keywords with missing synonyms matches the score-3 anchor; score 4 would require broader coverage of the natural phrasings around quota exhaustion and cache freshness.

3 / 5

Distinctiveness Conflict Risk

The tool-specific names 'Gitcrawl' and 'Octopool' carve out a clear niche with minimal conflict risk against unrelated skills. Minor overlap remains with any generic GitHub/gh usage skill, since 'GitHub' and 'gh' alone are broad triggers — fitting the 'mostly distinct; minor overlap risk' anchor rather than the fully distinct score-5 anchor.

4 / 5

Total

12

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
steipete/agent-scripts
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.