CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-failures

Diagnose a failing Ginkgo suite as an agent — always run with --json-report into a predictable temp/gitignored location, read the terminal verdict line, then use jq to extract structured failure details (name, message, file:line, panic value, captured logs). Covers the panicked-vs-failed trap, panic locations pointing into the Go runtime, parallel output interleaving, reproducing with --seed, and progress reports for hangs. Use when a suite failed and you need to know why. Also invokable as /ginkgo:debugging-failures.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

90%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: highly specific actions with concrete field names, an explicit 'Use when' trigger, and a distinct Ginkgo-diagnosis niche. Third-person voice throughout. Only minor gap is a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "always run with --json-report into a predictable temp/gitignored location", "read the terminal verdict line", "use jq to extract structured failure details (name, message, file:line, panic value, captured logs)" — with named fields, comprehensively covering the diagnostic procedure.

5 / 5

Completeness

It explicitly answers both what (the full JSON-first diagnostic procedure with named output fields) and when ("Use when a suite failed and you need to know why"), with a concrete trigger phrase — the clear match for the top anchor, not the weaker when-clause of the 4 anchor.

5 / 5

Trigger Term Quality

Good natural coverage — "failing Ginkgo suite", "suite failed", "panicked", "hangs", "--seed" — phrasings a Ginkgo user would actually say, but a few common variants ("test failure", "flaky", "Ginkgo test") are absent, matching the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear Ginkgo-specific niche (Ginkgo suites, --json-report, panicked specs, --seed reproduction) with distinct triggers and minimal risk of firing for unrelated skills; no closely related skill would collide on these terms.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

onsi/ginkgo

Path

plugins/ginkgo/skills/debugging-failures/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.