CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debug-container

Diagnose local container issues with Podman/Docker including image pull errors, container startup failures, OOM kills, and networking problems. Automates multi-step diagnosis: container inspect, logs retrieval, image analysis, and resource constraint checking. Use this skill when containers fail to run locally before deployment. Triggers on /debug-container command or phrases like "container won't start", "podman run fails", "local container crashing", "container exits immediately".

Quality

85%

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

73%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 body delivers a well-sequenced, checkpoint-driven diagnostic workflow with concrete tools and commands, and external details are properly pushed to one-level-deep references. Its weaknesses are redundant introductory sections that restate the description and prerequisites, inlined output templates that inflate token cost, and one orphaned bundle file with no inbound link.

Suggestions

Cut the redundant opening: remove the 'When to Use This Skill' section (it repeats the frontmatter description verbatim) and collapse the Overview line and 'This skill diagnoses' list into a single statement, keeping prerequisites solely in references/prerequisites.md.

Move the long per-step output templates (Steps 2-4 inspection/log/image tables) into a reference file such as references/output-templates.md, keeping only the tool call, the checkpoint, and one short example inline in SKILL.md.

Link references/selinux-troubleshooting.md from the body (e.g., from the volume-mount findings or diagnosis summary section) so the bundle's SELinux guidance is discoverable, since the description and summary already mention volume mount problems.

DimensionReasoningScore

Conciseness

The operational content (tool calls, commands, output templates) contains no concept explanations Claude already knows, but the same summary is repeated three times in the opening sections ("Diagnose local Podman/Docker container issues...", the "This skill diagnoses" bullet list, and "When to Use This Skill" which restates the frontmatter description verbatim), and the Prerequisites section duplicates references/prerequisites.md. This matches anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") rather than anchor 4, since several padded sections could be cut outright.

3 / 5

Actionability

Concrete MCP tool names (container_list, container_inspect, container_logs, image_list), executable bash fixes ("podman run --memory=1g [image]", "lsof -i :[port]", "podman run -it --entrypoint /bin/sh [image]"), and fully specified output templates give mostly executable guidance. It falls short of anchor 5 because the MCP invocations are named but never shown with arguments, and the bulk of the guidance is presentation templates with placeholders rather than copy-paste-ready commands covering common cases.

4 / 5

Workflow Clarity

Six clearly sequenced steps each end with an explicit bolded "WAIT for user confirmation before proceeding" checkpoint, per-step analysis acts as validation ("Quick Assessment", "Errors Found", error category tables), and the final menu plus Test Fix section (remove, re-run with fixes, run interactively) provides error-recovery feedback loops. Operations are read-only diagnosis or user-gated choices, so the destructive/batch validation cap does not apply; this matches anchor 5's explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

References are one level deep and well signaled (debugging-patterns.md linked three times with purpose text, human-in-the-loop.md and prerequisites.md listed with descriptions), and all three referenced paths exist in references/. However, selinux-troubleshooting.md exists in the bundle but is never referenced from the body (a discovery gap), and roughly 200 lines of presentation templates are inlined in SKILL.md when they could live in a reference file — minor organization gaps that fit anchor 4 rather than anchor 5's "content appropriately split".

4 / 5

Total

16

/

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 that explicitly states what it does, when to use it, and how it is triggered, with concrete actions and failure modes rather than vague claims. The only weakness is asymmetric trigger coverage: natural user phrases cover Podman but omit Docker-worded variants despite claiming Docker support.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ("container inspect, logs retrieval, image analysis, and resource constraint checking") plus specific failure modes ("image pull errors, container startup failures, OOM kills, and networking problems"), comprehensively covering the skill's diagnostic scope. It exceeds the anchor-4 example, which has minor coverage gaps; here the action list mirrors the full workflow.

5 / 5

Completeness

Both questions are explicitly answered: what ("Diagnose local container issues with Podman/Docker... Automates multi-step diagnosis: container inspect, logs retrieval, image analysis, and resource constraint checking") and when ("Use this skill when containers fail to run locally before deployment. Triggers on /debug-container command or phrases like...") with concrete trigger phrases, exactly matching the anchor-5 example pattern. Voice is third person ("Diagnoses", "Automates"), so no voice penalty applies.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ("container won't start", "podman run fails", "local container crashing", "container exits immediately") plus the explicit /debug-container command, but coverage is Podman-skewed. Despite claiming Docker support, no Docker-natural variants ("docker run fails", "docker container crash") or other common phrasings (e.g., "crash loop", "exit code 137") appear, matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche — local pre-deployment container failure diagnosis — with failure-specific trigger phrases that would not fire for build, deploy, or image-recommendation skills. The explicit scoping ("locally before deployment") minimizes overlap with deployment-oriented skills, matching anchor 5's "clear niche with distinct triggers; minimal conflict risk".

5 / 5

Total

19

/

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-container/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.