Content
88%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 well-crafted procedure skill: it gives copy-paste-ready gh commands, per-category search strategies, deterministic categorization rules, and a complete report format, with clear error-recovery paths for unverifiable claims. The only weaknesses are mild — some repeated caveats that could be trimmed, and all content inline in one long file rather than splitting the report template into a reference.
Suggestions
De-duplicate the 'technical accuracy only — use release-note-writer/frontmatter-description skills' caveat (stated in both the intro and Step 6) and the gh-cli-powershell.md memory pointer (stated in both 'Repos to Check' and Step 3); state each once.
Consider moving the findings-report template and the claims-category table into a references/ file (e.g., references/report-format.md) to keep SKILL.md as a leaner overview, which would also improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no concept explanations (nothing teaches what a PR or a keybinding is), and guidance like 'Prefer one targeted lookup per claim — do not download full files when a search will do' is maximally compressed. Minor trimmable redundancy keeps it below 5: the 'technical accuracy only, use other skills' caveat appears both in the intro and again in the Summary section, the `gh-cli-powershell.md` memory pointer is repeated twice, and 'do not push commits or post review comments' overlaps with the Notes framing. | 4 / 5 |
Actionability | Guidance is fully executable: exact commands with flags ('gh pr view <number> --json number,title,headRefName,baseRefName,files,body', 'gh search code --repo microsoft/vscode '"<exact-string>"'', 'gh api repos/microsoft/vscode/contents/<path>?ref=main'), concrete search starting points per claim category, a severity rubric with decision criteria, and a copy-paste report template. Specific examples cover the common cases (settings, commands, keybindings, API, chat tools, version availability) with an explicit fallback (gh api) for the known gh-search quoting pitfall. | 5 / 5 |
Workflow Clarity | A clear six-step sequence (identify diff → extract claims → verify → categorize → report → summarize) with explicit validation/error-recovery checkpoints: cosmetic files are skipped up front, a claim that cannot be verified is routed to 'Unverified' rather than failed ('mark it Unverified rather than failing it — the author may have access to context the source does not expose'), verification failure has a defined handling path, and the verdict rule is deterministic ('any Errors → Needs changes'). This is a read-only review, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist and every section is well-organized with clear headers, tables, and a fenced template, so navigation is easy and nothing is buried. It falls short of 5 because the skill is a single ~145-line monolith with no content split at all — the output report template (~30 lines) and the claims-category table could live in a references/ file if the token budget mattered — and the under-50-line simple-skill exception does not apply at this length. | 4 / 5 |
Total | 18 / 20 Passed |