Content
57%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.
The skill body is well-organized and packed with concrete, actionable tool guidance, but it suffers from duplicated pitfalls, a filler closing line, and no progressive disclosure to reference files. Destructive workflows also lack inline validation checkpoints.
Suggestions
Move the consolidated "Known Pitfalls" and detailed parameter reference into a references/ file (e.g. PITFALLS.md, REFERENCE.md) and link from the body to reduce duplication and enable progressive disclosure.
Add an explicit "Confirm with the user before running" checkpoint inline in the delete-repository and delete-issue tool sequences.
Remove or replace the empty "When to Use" section with concrete trigger guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense and operational, but pitfalls are duplicated between each workflow's "Pitfalls" subsection and the consolidated "Known Pitfalls" section, and the closing "When to Use" line ("applicable to execute the workflow or actions described in the overview") is filler that could be trimmed. | 3 / 5 |
Actionability | Concrete tool slugs, exact parameter values (e.g. state OPEN/MERGED/DECLINED, kind bug/enhancement/...), and a Quick Reference table give mostly executable guidance, though no fully-assembled example tool calls are shown. | 4 / 5 |
Workflow Clarity | Numbered tool sequences with [Prerequisite]/[Required]/[Optional] tags and an ACTIVE-connection check are clear, but destructive operations (DELETE_REPOSITORY, DELETE_ISSUE) lack an inline validation/confirm checkpoint in their sequences, capping workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | Content is well-sectioned with headers and a Quick Reference table, but it is a single ~220-line monolith with no external reference files, and detailed parameter/pitfall material that could be split out is inlined. | 3 / 5 |
Total | 13 / 20 Passed |