Content
71%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 clear, well-structured single-file skill with an unambiguous flow and good failure handling. Its main weaknesses are redundancy — the gh install/auth and pagination/jq guidance is repeated across Prerequisites, Skill Flow, and Rules — and the absence of the full assembled gh api command line, which keeps actionability and conciseness in the middle-upper range.
Suggestions
Write out the complete fetch command once, e.g. `gh api --paginate repos/microsoft/agent-academy/stargazers --jq '[.[] | {login, type, url}]' > temp/stargazers.json`, instead of describing its flags across separate steps and rules.
Remove the duplicated install/auth instructions from the Rules section and keep them only in Prerequisites (the Skill Flow already points back to it), eliminating three restatements of the same guidance.
Add a light post-fetch checkpoint, e.g. verify the saved file is non-empty valid JSON before reporting the count, to close the workflow's only validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but repeats the same instructions in three places: the Prerequisites section, Skill Flow step 1 ("verify the gh CLI is installed and authenticated"), and Rules bullets 5–6 restate the install/auth guidance; Rules 1–2 likewise restate the --paginate and --jq instructions from Skill Flow step 2. Consolidating these into one place would tighten the skill noticeably, fitting the anchor "mostly efficient but includes some unnecessary explanation or could be tightened". | 3 / 5 |
Actionability | Concrete commands are given (gh --version, gh auth status, --jq '[.[] | {login, type, url}]', per_page=100) and each flow step is executable in intent, but the actual full command — including the endpoint path repos/microsoft/agent-academy/stargazers — is never written out as a copy-paste line. That is a minor gap consistent with "mostly executable guidance; concrete code or commands with minor gaps" rather than a 3, since every parameter and filter is still specified. | 4 / 5 |
Workflow Clarity | The five-step flow is clearly sequenced with an explicit pre-flight gate ("Do not proceed with the rest of the skill until both checks pass") and failure handling ("If the API request fails... report the error clearly and do not write a partial or empty file"). It falls short of anchor 5 only because there is no post-fetch validation step (e.g., verifying the saved JSON parsed and has a sensible count before reporting), and short of the destructive/batch cap is not triggered since the operation is read-only plus one file write. | 4 / 5 |
Progressive Disclosure | This is a simple, single-purpose skill (~40 lines) with no bundle files (references/, scripts/, assets/ are all absent), so nothing needs to be split out. It is organized into three well-labeled sections (Prerequisites, Skill Flow, Rules) with no nested references, matching the rubric's exception that short single-file skills with well-organized sections score 5. | 5 / 5 |
Total | 16 / 20 Passed |