Content
76%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 body is an exceptionally concrete, actionable instruction set with copy-paste templates, explicit correct/wrong examples, and a worked transformation — actionability is essentially maxed for an instruction-only skill. Its weaknesses are workflow-level: no validate/fix/retry feedback loop for a batch, destructive operation, no post-migration verification, and small coherence defects (duplicate section numbering, an internal contradiction about closing originals).
Suggestions
Add post-migration verification with an error-recovery loop, e.g. 'After creating each issue, verify mentions are backticked and references resolve; if any ping or mislink, edit the issue/comment immediately and re-verify.'
Fix the duplicate '### 5.' numbering and reconcile the contradiction between 'Close the original issue as not_planned' and the checklist item 'Decide whether to close original issues after migration' — either make closing conditional in both places or mandatory in both.
Trim redundancy by folding the checklist's verification items into the requirements they mirror, or convert the checklist into a run-through sequence so it adds ordering value rather than repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive throughout — exact templates, correct/incorrect contrasts, and a worked example — with no explanations of concepts Claude already knows. Minor over-explanation exists: the 'Checklist Before Migration' repeats requirements 3-4 ('Verify all `@mentions` are wrapped in backticks', 'Verify all `#NUMBER` references are converted to full URLs') and the Example Transformation largely restates those same rules. Fits anchor 4 ('efficient; minor instances that could be trimmed') rather than anchor 5. | 4 / 5 |
Actionability | Fully copy-paste-ready guidance: exact markdown templates ('_Transferred from {SOURCE_REPO}#{ORIGINAL_ISSUE_NUMBER}_', '_`@{COMMENT_AUTHOR}` commented:_'), explicit correct/incorrect examples ('✅ Correct: `https://github.com/microsoft/vscode-copilot/issues/12345`', '❌ Wrong: `#12345`'), a complete worked before/after transformation, and a concrete close state ('not_planned'). Per the rubric's instruction-skill note, the absence of gh CLI commands is not penalized since the transformation guidance is fully executable. | 5 / 5 |
Workflow Clarity | This is a batch and destructive operation ('All matching issues will be migrated', 'Close the original issue as not_planned'), and while a pre-flight checklist exists, there is no feedback loop (no validate-after-creation, fix, and retry guidance) and no post-migration verification — the rubric caps batch/destructive skills without feedback loops at 3. Coherence is also weakened by duplicate '### 5.' section numbering and a contradiction between 'Close the original issue as not_planned' (requirement) and the checklist's 'Decide whether to close original issues after migration'. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the ~170-line body is well organized into clearly headed sections (Input Methods, Task, Requirements, Example Transformation, Checklist) with no nested or buried references. It sits below anchor 5 because the skill exceeds 50 lines and content like the Example Transformation or the query-filter table could plausibly live in a reference file, and the duplicate '### 5.' numbering is a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |