Content
75%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 compact, highly actionable reference with copy-paste-ready gh commands and a clear numbered CI-debugging workflow. The main flaw is redundancy: the same four commands appear twice, which hurts both conciseness and overall length.
Suggestions
Consolidate the duplicated commands: keep the "Debugging a CI Failure" sequence and remove the verbatim repeats from the "Pull Requests" section (or vice versa), linking the workflow to the command list once.
Add a brief error-recovery note in the debugging workflow (e.g., what to do when a check name is ambiguous or logs are truncated) to strengthen the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean with concrete commands and no concept explanations, but the four commands in "Pull Requests" (gh pr checks, gh run list, gh run view, gh run view --log-failed) are repeated verbatim in the "Debugging a CI Failure" sequence. This duplication is a clear tightening opportunity, matching anchor 3 rather than 4 where only minor trimming would be needed. | 3 / 5 |
Actionability | Every example is a copy-paste-ready executable command with realistic arguments (e.g., "gh pr checks 55 --repo owner/repo", "gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'", the --json/--jq issue list), covering the common cases of CI debugging, API field selection, and structured output. Not below 5: no pseudocode and no missing key details. | 5 / 5 |
Workflow Clarity | The "Debugging a CI Failure" section gives a clear numbered 4-step sequence with bolded step purposes, each step feeding the next (check status → find run ID → view run → fetch logs). The operations are read-only so destructive-operation validation is not required, but anchor 5 demands explicit validation/error-recovery checkpoints which are absent, so anchor 4 fits best. | 4 / 5 |
Progressive Disclosure | Sections are well-organized (When to Use, Pull Requests, Debugging, API, JSON Output) with no bundle files and no content that clearly belongs in separate files — good structure. It falls short of 5 because the body is ~70 lines (above the under-50 simple-skill guideline) and the command duplication inflates length where consolidation would tighten navigation. | 4 / 5 |
Total | 16 / 20 Passed |