Content
73%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 well-sequenced, concrete authoring workflow with genuine validation checkpoints — but it is broken as shipped: every authoring step depends on template.sh, which is referenced but not present in the skill bundle. Fixing the packaging (shipping the template) would likely move this to a top-tier score.
Suggestions
Ship template.sh in the bundle (skill root or scripts/) — the entire Process section is unexecutable without it, since 'Copy template.sh to the target path. Replace the example stage...' has no source file to copy.
Include one minimal inline example of an authored stage so the skill degrades gracefully if the template cannot be located.
Trim the intro's restatement of the description's use cases ("It might configure third-party services, run a one-off migration...") and the UX description already guaranteed by template.sh.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no generic bash or secret-management explanations. Minor trimmable padding: the intro's last sentence ("It might configure third-party services, run a one-off migration, or move the project from one state to another") restates the description's trigger list, and it re-describes UX details ("opens each URL, says exactly what to click and copy...") that template.sh already embodies. This puts it between anchors 4 and 5, closer to efficient-with-minor-trims than to every-token-earns-its-place. | 4 / 5 |
Actionability | Highly concrete: names the exact helpers ("stage, say/step, open_url, ask/ask_secret, write_env, set_secret/set_var, pause/confirm"), exact verification commands ("bash -n <script>", "shellcheck", "chmod +x"), and exact repo files to scan (".env, .env.example, .github/workflows/*"). Not anchor 5 because stage authoring is never shown — no inline example of one stage — and "Copy template.sh to the target path. Replace the example stage..." delegates entirely to a file; guidance is executable only if that file exists (see progressive_disclosure). | 4 / 5 |
Workflow Clarity | Four numbered phases each end in an explicit checkpoint ("**Done when:** every stage is named in order..."), the user confirms the stage list before authoring, "confirm before any irreversible action" gates destructive steps, and a dedicated verification phase runs bash -n/shellcheck plus a static trace ("every set_secret name exactly matches a secrets.* reference in CI") with clear feedback on what to check. This matches the anchor's sequence-with-explicit-validation-and-checklists pattern. | 5 / 5 |
Progressive Disclosure | Per the guideline to score against the actual bundle structure and referenced paths: the body's single external reference, "[template.sh](template.sh)", is a dangling link — no references/, scripts/, or assets/ directories exist and template.sh is absent from the bundle. Since the skill's central asset ("Copy template.sh to the target path") is missing, the disclosure chain fails at its only link. Not 1 because the body itself is well-sectioned rather than a monolith; not 3 because a broken reference to the skill's core dependency is worse than a present-but-unclearly-signaled one. | 2 / 5 |
Total | 15 / 20 Passed |