Content
86%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 model of token-efficient, sequenced instruction for an external-write task, with a genuine safety gate on the irreversible action. The remaining gap is executable specificity: what 'inspect vercel/ai' should check for and what the issue body should actually look like.
Suggestions
Replace "inspect vercel/ai" with the concrete checks intended, e.g. search existing issues for duplicates and read the repo's issue template.
Include a compact example issue body (or the exact section headings) so the --body-file format is copy-paste ready.
State the expected failure handling when gh auth status fails or issue creation errors, closing the workflow's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Ten lean lines with no padding and no explanations of concepts Claude already knows (no gh CLI tutorial, no issue-format primer); every token earns its place, matching the 'lean and efficient' anchor. | 5 / 5 |
Actionability | Concrete executable commands are given ("gh auth status", "gh issue create -R vercel/ai --title \"<title>\" --body-file <file>"), but "inspect vercel/ai" is unspecified, no example issue body or template is provided, and the command placeholders are left for Claude to construct, so it sits at 'mostly executable with minor gaps' rather than copy-paste ready. | 4 / 5 |
Workflow Clarity | Five clearly-sequenced steps include a precheck ("Confirm gh auth status") and an explicit gate on the risky external write ("Do not create the external issue unless the user has authorized that write"). Issue creation is not destructive or batch, so the score-3 cap does not apply, but "inspect vercel/ai" leaves the validation intent implicit, holding this at the 'most checkpoints present, minor gaps' anchor. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, with no bundle files present and no external references needed; the numbered list plus standalone safety note is well-organized, which the simple-skill guidance rates at the top anchor. | 5 / 5 |
Total | 18 / 20 Passed |