Content
63%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 content is highly actionable with concrete gh commands, body templates, and a clear branching workflow supported by error handling. Its weaknesses are verbosity from repeated inlined question scaffolding and the absence of progressive disclosure into separate reference files.
Suggestions
Condense the repeated AskUserQuestion blocks into brief 'ask the user for X' instructions to cut roughly half the body length.
Extract the full question/option scaffolding and body templates into a reference file (e.g. references/templates.md) and link to it from SKILL.md to improve progressive disclosure.
Replace the literal '--label "[labels]"' placeholder with conditional guidance so the create command is fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At ~248 lines the body repeats full AskUserQuestion scaffolding six-plus times and includes guidance sections ('Title guidelines', 'Description guidelines') that could be trimmed; it avoids concept-explanation fluff (no explanation of GitHub or issues), so it is mostly efficient but noticeably tighten-able, fitting anchor 3 rather than the verbose anchor 2. | 3 / 5 |
Actionability | Provides concrete, executable commands ('gh issue create', 'gh issue list --assignee @me', 'gh issue view [number]'), body templates, and a HEREDOC example; minor gaps like the literal '--label "[labels]"' placeholder keep it at 'mostly executable; minor gaps' rather than the fully-copy-paste anchor 5. | 4 / 5 |
Workflow Clarity | Clear Step 1 → 5a / 3b / 3c sequencing across the three branches, plus a success-confirmation checkpoint ('show the URL') and an Error Handling feedback loop; lacks an explicit validate-then-proceed loop, fitting 'clear sequence with most checkpoints present; minor validation gaps' rather than anchor 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single monolithic document with good section headers, but the repeated question scaffolding is inlined rather than split into a reference file; at 248 lines it exceeds the under-50-line simple-skill exception, fitting 'some structure but could be better organized; content that should be separate is inline'. | 3 / 5 |
Total | 14 / 20 Passed |