CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debug-build

Diagnose OpenShift build failures including S2I builds, Docker/Podman builds, and BuildConfig issues. Automates multi-step diagnosis: BuildConfig validation, build pod logs, registry authentication, and source repository access. Use this skill when builds fail, hang, or produce unexpected results. Triggers on /debug-build command or phrases like "build failed", "S2I error", "can't pull builder image", "can't push to registry", "build timeout".

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The content's core strength is an exemplary six-step workflow with explicit WAIT checkpoints after every step, a fix-retry loop, and concrete MCP tool assignments and oc commands. Weighing it down are token padding (a when-to-use section duplicating the description and verbose placeholder templates) and a bundle where most referenced files are contentless pointer stubs — including the file the body labels as holding mandatory human-in-the-loop behavior.

Suggestions

Delete the "When to Use This Skill" section (it duplicates the frontmatter description) and trim illustrative placeholder rows from the markdown output templates to reduce token overhead.

Put actual content into references/human-in-the-loop.md — it is currently a one-line pointer to ../../validate-environment/references/ and the body marks it "Critical" for mandatory checkpoint behavior; likewise fix or remove the empty pointer stubs builder-images.md, python-s2i-entrypoints.md, and prerequisites.md.

Link selinux-troubleshooting.md from the Reference Documentation section of SKILL.md or fold it into debugging-patterns.md: it is currently reachable only through a second-level reference and itself points to a third skill's file (../../rhel-deploy/), exceeding the one-level-deep guideline.

DimensionReasoningScore

Conciseness

The ~300-line body is mostly purposeful output templates, but carries removable padding: the "When to Use This Skill" section restates the frontmatter description nearly verbatim ("Use this skill when OpenShift builds fail, hang, or produce unexpected results"), tables include illustrative placeholder rows (e.g., "[app-1] | [app] | Failed | [timestamp]"), and Step 4 re-explains S2I phases Claude can be assumed to know ("assemble: Installs dependencies and builds application"). This fits anchor 3 (mostly efficient but could be tightened) better than anchor 4, since the redundancy is more than minor.

3 / 5

Actionability

Concrete, executable guidance throughout: specific MCP tool assignments ("Use kubernetes MCP `resources_get` to get Build details", "Use kubernetes MCP `pods_log` for the builder pod"), copy-paste fix commands ("oc start-build [buildconfig-name] -n [namespace] --follow", "oc import-image nodejs:18 --from=registry.access.redhat.com/ubi9/nodejs-18"), and exact output templates. It falls short of anchor 5 because the MCP invocations are named but never shown with concrete call syntax, and much of the body is output-format templates with bracketed placeholders rather than fully copy-paste ready instructions.

4 / 5

Workflow Clarity

Six explicitly sequenced steps (identify target → build status → BuildConfig analysis → build pod logs → related resources → diagnosis summary), each ending in an explicit validation checkpoint ("**WAIT for user confirmation before proceeding.**"), with a fix-retry feedback loop in Step 6 ("Would you like me to: 1. Execute one of the recommended fixes 2. Retry the build...") and a root-cause category checklist table. This matches anchor 5's clear sequence with explicit validation, feedback loops, and checklists; the skill is read-only diagnosis, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The SKILL.md itself is well organized with clearly signaled, purpose-labeled references ("[references/debugging-patterns.md](references/debugging-patterns.md) - Common error patterns"), but scoring against the actual bundle reveals that 4 of the 5 referenced files (human-in-the-loop.md, builder-images.md, python-s2i-entrypoints.md, prerequisites.md) contain only one-line cross-skill pointer paths with no content — so the "Critical: Human-in-the-Loop Requirements" section delegates mandatory checkpoint behavior to an empty stub — and debugging-patterns.md chains onward to selinux-troubleshooting.md (itself a pointer stub, unreferenced from SKILL.md), creating 2+ levels of indirection. Good in-body signaling but a bundle structure that undermines navigation places this at anchor 3 rather than 4.

3 / 5

Total

15

/

20

Passed

Description

88%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: it names the domain (OpenShift builds, S2I, Docker/Podman, BuildConfig) with four concrete diagnosis actions, and explicitly answers both what and when using natural trigger phrases and the /debug-build command. The only weaknesses are minor — a few natural trigger variations are missing, and phrases like "build failed" and "build timeout" are generic enough to slightly overlap with non-OpenShift build skills.

DimensionReasoningScore

Specificity

"Diagnose OpenShift build failures including S2I builds, Docker/Podman builds, and BuildConfig issues" plus "Automates multi-step diagnosis: BuildConfig validation, build pod logs, registry authentication, and source repository access" names the domain and four concrete diagnosis actions with no notable coverage gap. This matches the anchor-5 pattern of multiple specific concrete actions with comprehensive coverage; it exceeds anchor 4 because the actions span all the main failure areas (source, builder image, logs, registry).

5 / 5

Completeness

Both questions are explicitly answered: what ("Diagnose OpenShift build failures... BuildConfig validation, build pod logs, registry authentication, and source repository access") and when ("Use this skill when builds fail, hang, or produce unexpected results. Triggers on /debug-build command or phrases like...") with concrete trigger phrases. This matches the anchor-5 example structure exactly; anchor 4 would require the 'when' to be less explicit or missing concrete phrases, which is not the case.

5 / 5

Trigger Term Quality

Natural user phrases are present: "build failed", "S2I error", "can't pull builder image", "can't push to registry", "build timeout", plus the explicit "/debug-build command" trigger and "when builds fail, hang, or produce unexpected results". Good keyword coverage, but a few natural terms a user would say are missing (e.g., "build stuck", generic "build error", "BuildConfig problem"), so it sits between anchors 4 and 5 — noticeably above the midpoint rather than clearly matching the comprehensive-coverage anchor.

4 / 5

Distinctiveness Conflict Risk

OpenShift/S2I framing gives it a clear niche with distinct triggers ("S2I error", "can't pull builder image"), but the fairly generic phrases "build failed" and "build timeout" carry minor overlap risk with general CI/CD or container build skills. It is well above anchor 3 (which would overlap broadly with similar skills) but does not fully meet anchor 5's 'minimal conflict risk' because of those generic trigger phrases.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

RHEcosystemAppEng/agentic-plugins

Path

rh-developer/skills/debug-build/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.