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.
An unusually well-executed procedural skill: every step carries project-specific knowledge Claude could not infer, commands are copy-paste ready, and validation with recovery loops is woven through a batch operation. The only refinement opportunities are tightening a few explanatory asides and potentially moving the PR-body formatting conventions to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, repo-specific knowledge (PWB vs Positron marker rules, version/distro baseline parity, backport direction checks, full-qualified reference rules) and explains nothing Claude already knows at length. A few spots could be tightened — e.g., the explanation that 'GitHub-flavored markdown does not render native list syntax inside a table cell' and the long PR-body template in Step 5 — landing it at anchor 4 rather than the lean anchor 5. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste commands (the two bundle scripts with arguments, `git rev-parse upstream/main`, `npm run build-ps/build-check/precommit --`, `gh pr list ... --search "upstream merge from vscode-server in:title"`), a literal commit-message template, and a concrete PR-body markdown template. Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced with explicit validation checkpoints and feedback loops for a batch operation: stop conditions on baseline divergence (version/distro mismatch, Microsoft-author commits), build-check with recovery ('if watch-client is stopped, run build-start first'), precommit scoped to touched lines, `git status` churn exclusion before committing, and a 'files you ported compile clean' acceptance criterion. This matches anchor 5's explicit validation with error-recovery loops; the destructive/batch cap of 3 does not apply since validation is thorough. | 5 / 5 |
Progressive Disclosure | Both script paths referenced in the body (`scripts/enumerate-upstream.sh`, `scripts/check-backlog.sh`) exist in the bundle and are clearly signaled as executable helpers at the point of use, and the SKILL.md itself serves as the workflow overview. Scored against the actual bundle structure, this is good structure (anchor 4) — though the ~40 lines of PR-body formatting rules and reference conventions in Step 5 are arguably bulk material that could live in a reference file, keeping it short of anchor 5's clean overview-plus-references split. | 4 / 5 |
Total | 18 / 20 Passed |