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 compact, well-structured single-purpose skill with genuinely actionable rendering rules and no bundle bloat. Its main weakness is redundancy between the Purpose and Usage sections, plus a missing example of the final table that would make the guidance fully copy-paste ready.
Suggestions
Merge the Purpose and Usage sections into one short statement — they restate the same idea twice.
Add a small example of a rendered markdown table for a typical search result to make the guidance fully concrete.
Replace the vague 'any other relevant details' with a specific list of candidate fields (title, author, labels, state, updated date) or an explicit rule for choosing them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Purpose and Usage sections largely repeat each other ('easy to read and understand', restating that the skill builds a markdown table), and phrases like 'without having to parse through raw data' pad what Claude can infer. Mostly efficient but could be tightened by merging the two sections. | 3 / 5 |
Actionability | Concrete, executable rules are given: the exact link format '[#123](https://github.com/owner/repo/issues/123)', dropping columns implied by the query, and 'is:pr' mapping to review/merge status. Minor gaps keep it below 5: 'any other relevant details' is loose and no example table is shown. | 4 / 5 |
Workflow Clarity | The single task is unambiguous and the column-selection rules form a clear decision procedure, with no risky operations requiring validation. Minor gaps (no rendered example, no guidance for edge cases like empty results or very long lists) hold it below 5. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines, uses clean section headers (Purpose, Usage, How to Render), and needs no external references — none exist in the bundle — satisfying the simple-skill criterion for full marks. | 5 / 5 |
Total | 16 / 20 Passed |