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.
An exemplary dense reference: every section leads with a runnable command or code sample, and the value is concentrated in non-obvious gotchas (parallel report-node interleaving, focus breaking profiles, -vv embedded in machine reports) that Claude cannot be assumed to know. The only soft spots are the absence of any output-verification checkpoints and a fully inline structure with no reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — a flag table instead of prose ('| -vv | -v plus node > Enter/< Exit events and every failure |'), compressed gotchas ('Focused specs break profiling'), and non-obvious facts only Claude wouldn't know ('Every machine-readable report embeds the full -vv timeline regardless of console verbosity'). Nothing explains basics Ginkgo users already know; every token earns its place. Not 4: there is no identifiable padding to trim. | 5 / 5 |
Actionability | Concrete, copy-paste-ready commands and code cover the common cases: 'ginkgo -r --json-report=report.json --output-dir=./.reports', an executable ReportAfterSuite file-writing example, an AddReportEntry call with visibility, and a full profiling command with --coverpkg and pprof usage. Not 4: the examples span each of the skill's five topic areas with exact flags and runnable Go, leaving only negligible gaps (e.g., the example ignores os.Create's error). | 5 / 5 |
Workflow Clarity | Each task path is unambiguous with strong decision guidance ('don't roll your own in AfterEach — use reporting nodes', 'ReportAfterSuite ... is the safe place for custom suite-level report files', 'Subset with filters, not Focus') and failure-mode warnings (parallel interleaving garbage, focus breaking profiles). Not 5: this is a multi-topic reference with no verification checkpoints anywhere — e.g., nothing tells the reader to confirm the report file was written or check the exit code after a profiling run, which is the 'minor validation gaps' position between anchors. | 4 / 5 |
Progressive Disclosure | Well-organized single-file body with clear section headers, and all cross-references are one level deep and clearly signaled ('→ ginkgo:debugging-failures', '→ ginkgo:ci', two external doc URLs up top). Not 5: no bundle reference files exist to offload detail, so everything lives inline in a ~90-line body, and inline recaps of sibling-skill territory (the GinkgoWriter/By recap, profiling coverage flags) sit between the 'appropriately split' anchor and 'good structure, most content appropriately placed'. Not 3: structure and navigation are unambiguous, and no reference is buried. | 4 / 5 |
Total | 18 / 20 Passed |