Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, actionable skill body: the one non-obvious fact is stated up front, commands are nearly all executable, and edge cases (first-time setup, history/branch caveats, private-data warning) are covered concisely. The only weaknesses are the placeholder in the sync command and the missing wait-for-initial-sync checkpoint.
Suggestions
Make the sync step fully executable, e.g. `bash "$(find ~/.claude ~/.codex -name private-github-search-sync.sh 2>/dev/null | sort -V | tail -1)"`, so no manual substitution is needed.
In First-time setup, state that the initial search must wait until the background sync finishes (e.g. check for completion or poll owners count) so the mirror isn't searched while partially cloned.
Note what the mirror contains (code and files on the default branch) so searches over issues or non-code content are correctly redirected.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | About 30 lean lines where every token earns its place; the single explanatory sentence (why gh search code fails on private repos) is non-obvious justification rather than padding, and no concepts Claude already knows are re-explained. | 5 / 5 |
Actionability | The find command and both rg invocations are copy-paste ready, but `bash <script-path>` requires manual substitution — a minor gap versus the fully-executable anchor 5, though the preceding find step does locate the path. | 4 / 5 |
Workflow Clarity | Clear sequence (locate script, refresh, search) with a cold-start check (owners.txt existence) and documented sync idempotence, but it never says to wait for the background initial clone before searching — a minor checkpoint gap versus anchor 5. | 4 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references, and content is well-organized into Searching, First-time setup, and Caveats sections, which per the rubric's simple-skill guideline merits a 5. | 5 / 5 |
Total | 18 / 20 Passed |