Content
92%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 strong operational skill body: highly actionable CLI commands, a well-sequenced six-step procedure with explicit validation gates, and clean conditional navigation into a verified bundle of reference files. The only weakness is mild verbosity in step qualifiers and version-pinned details embedded in Error Handling rather than a dedicated compatibility section.
Suggestions
Move version-pinned compatibility details (e.g., 'In gh aw v0.58.3, engine.max-turns is not supported for Copilot, bash must be true, false, or an allowlist...') into a dedicated 'Version compatibility' or 'Deprecated/old patterns' section in a reference file so they don't age the main procedure.
Tighten hedged qualifiers in Steps 3–4 (e.g., 'unless the workflow intentionally uses checked-in files from that path', 'unless the task is explicitly a low-risk public workflow') into shorter exception clauses, cutting token cost without losing the guardrail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (trial host-repo secrets, './' path semantics, matrix concurrency cancellation) and explains nothing Claude already knows, but several step items carry wordy qualifiers that could be tightened ('unless the workflow intentionally uses checked-in files from that path'), and a version pin ('In `gh aw v0.58.3`, `engine.max-turns` is not supported for Copilot...') sits in Error Handling rather than a dedicated deprecated/old-patterns section, which the rubric flags as time-sensitive information penalizing conciseness. Solidly above the midpoint but not the 'every token earns its place' anchor. | 4 / 5 |
Actionability | Concrete, executable commands appear throughout: 'gh aw fix --write', 'gh aw validate --strict', 'gh aw compile --verbose', 'gh aw run <workflow> --dry-run', 'gh aw trial ./.github/workflows/<workflow>.md', 'gh secret list -R <host-repo>', 'gh aw secrets bootstrap'. Specific gotchas (PAT vs gho_ token, delete_repo scope, './' path requirement) make the guidance copy-paste ready, matching the 5 anchor for an instruction-only skill. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps (identify state → choose mode → author → configure prerequisites → validate/compile/execute → operate) with explicit validation checkpoints ('Run gh aw validate --strict before treating a workflow as ready', compile after validation, dry-run before direct execution) and an Error Handling section providing feedback loops for error recovery (fix frontmatter before continuing, inspect permissions inheritance before changing worker logic). Matches the 5 anchor's explicit validation plus error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a navigable overview with well-signaled, one-level-deep, conditionally-triggered references ('Read references/authoring.md before editing', 'Read references/examples.md when the task needs a starting pattern', 'Read references/troubleshooting.md when the workflow fails to compile'), and every referenced path (references/authoring.md, examples.md, security-and-operations.md, troubleshooting.md, scripts/find-gh-aw-targets.mjs, assets/workflow.template.md) exists in the actual bundle. Deep operational detail is correctly deferred to the reference files. | 5 / 5 |
Total | 19 / 20 Passed |