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.
A tight, highly actionable read-only workflow: every command, output string, and failure stop-condition is concrete, and detail is properly delegated to the sibling sync-changelog skill. The weaknesses are minor — some redundant restatement of the read-only rule and the GitHub link caveat, and one overlong collapse-rules paragraph that hurts scannability.
Suggestions
State the read-only constraint once (e.g., in Rules) and remove the repetitions in the intro and step 4; likewise explain the GitHub-link-target caveat only in step 4 where the link is emitted.
Break the 'Collapse low-signal entries' bullet into short sub-bullets (reader-action test / channel test / section density / catch-all wording / pointer sentence) or move the shared folding rules into the sync-changelog reference so both skills cite one source.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely task-specific policy with no concept explanations or padding, but 'Read-only / writes no files' is stated three times (intro, step 4, Rules) and the note that the GitHub link target 'does not yet contain this version's block' is explained twice nearly verbatim. The ~450-word single 'Collapse low-signal entries' bullet also needs tightening rather than trimming of whole concepts. | 4 / 5 |
Actionability | Copy-paste-ready 'gh pr list' and 'gh api' commands with exact --jq filters, verbatim Chinese catch-all strings, a concrete output template, and an exact URL-rewrite mapping with a worked example. The strip/classify/translate detail is delegated but with precise numbered-step references to sync-changelog. | 5 / 5 |
Workflow Clarity | Four numbered steps with explicit stop conditions at every failure mode ('If none is open, nothing to preview — stop', 'not in the diff … stop and tell the user', 'not in English, flag it and stop'), a PR disambiguation rule (headRefName: changeset-release/main), and CI-status reporting. The skill is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the sibling-skill reference ('Read sync-changelog first') is well-signaled and one level deep, and sections are clearly organized. However, the collapse-rules bullet in step 3 is a dense wall of text (~450 words in one bullet) that should be split out or broken up, leaving a minor organization gap. | 4 / 5 |
Total | 18 / 20 Passed |