Content
90%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.
Excellent single-file skill body: copy-paste-ready commands and tested jq filters, a clear one-run diagnosis workflow, and dense coverage of real agent traps with zero padding. The only weaknesses are implicit verification checkpoints in the workflow and reference-shaped material (filters/schema facts) living inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — no 'what is Ginkgo' padding, terse sections like 'The three traps that bite agents' and 'Schema facts you need' deliver only non-obvious, empirically grounded detail. Every token earns its place; I could not identify a trimmable passage, so it fits the top anchor rather than the 'minor over-explanation' anchor below it. | 5 / 5 |
Actionability | Fully executable end to end: the exact run command ("ginkgo -r -p --no-color --json-report=report.json --output-dir=.ginkgo-report"), five copy-paste-ready jq filters, exact JSON field names, and precise signal/flag guidance ("SIGUSR1 on Linux", "--poll-progress-after=120s"). Covers the common failure cases, matching the copy-paste-ready anchor rather than the minor-gaps anchor. | 5 / 5 |
Workflow Clarity | The core workflow is an explicit numbered sequence (read terminal verdict → jq extraction only if failures → clean up) extended by a reproduce-focus-rerun narrowing loop. Checkpoints are mostly implicit (e.g., no check that the report file was written, no explicit re-validate step), which fits the 4 anchor 'clear sequence with most checkpoints; minor validation gaps' — not 5 because no explicit validation/feedback step exists, and not 3 because the sequence, conditionals, and cleanup are all explicit and the operation is non-destructive. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the single ~95-line body is organized into clear, well-labeled sections with clearly signaled one-level-deep cross-links ("→ ginkgo:filtering", "→ ginkgo:timeouts-and-async") and a docs URL. This is good structure with a minor gap — the jq-filter catalog and schema facts are reference-shaped content kept inline — so it matches the 4 anchor rather than 5 (content not split) or 3 (structure is clear, nothing buried). | 4 / 5 |
Total | 18 / 20 Passed |