CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnose-ci-failures

Diagnose a failed CI run: pull logs, isolate the failing step, plan the fix. Trigger: CI red, check the pipeline.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./ywai/skills/diagnose-ci-failures/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, actionable single-file skill with a clear sequenced workflow and concrete executable commands. Its main weaknesses are mild redundancy (the Example Commands section repeats workflow commands) and the absence of error-recovery feedback loops in the workflow.

Suggestions

Trim or merge the "Example Commands" section, since its entries duplicate commands already shown in the workflow steps; keep only the grep-based log-search example that adds new value.

Add a brief recovery step for when log extraction fails or the run ID cannot be resolved from the status check rollup (e.g., fall back to `gh run list --branch <branch-name> --limit 5`).

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence (no explanations of what CI or gh is), but the "Example Commands" section largely duplicates commands already shown in the workflow (gh pr view --json, gh run view --log-failed). This matches anchor 4 (minor trimmable redundancy) rather than 5 (every token earning its place).

4 / 5

Actionability

Concrete, mostly copy-paste-ready commands appear throughout ("GH_PAGER=cat gh pr view <branch-name> --json statusCheckRollup", "gh run view <run-id> --log-failed 2>&1 | grep -A 5 \"error:\""), with clear parsing targets. Minor gaps (the create_plan tool reference and placeholder values) keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

A clearly sequenced 5-step workflow (verify PR, check CI status, extract logs, categorize errors, generate plan) with explicit conditional handling ("If no PR exists...", "If CI is still running..."). The skill is read-only diagnosis so the destructive/batch validation cap does not apply; it stays at 4 rather than 5 because there are no feedback loops for error recovery (e.g., what to do if log extraction fails or the run ID is missing).

4 / 5

Progressive Disclosure

No bundle files exist, and the ~110-line body is well organized into labeled sections with references to companion skills (fix-errors, create-pr) clearly signaled. It matches anchor 4 (good structure, minor organization gaps); the under-50-line simple-skill exception for a 5 does not apply, and sections like "Common CI Check Names" and "Example Commands" are modest inline reference material that could be split out.

4 / 5

Total

16

/

20

Passed

Description

67%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 concise, third-person description that clearly states what the skill does and includes explicit trigger guidance. Its main weakness is thin trigger-term coverage: only two terse trigger phrases where natural variations like "build failed" or "tests failing" are absent.

Suggestions

Expand the trigger clause with natural variations users would actually say, e.g. "Trigger: CI red, build failed, tests failing, check the pipeline / CI checks".

Broaden the capability list slightly to cover the full workflow (e.g., "check CI status, pull failure logs, categorize errors, and plan the fix") for more comprehensive specificity.

DimensionReasoningScore

Specificity

"pull logs, isolate the failing step, plan the fix" lists several concrete, specific actions in the CI domain, though coverage has minor gaps (e.g., no mention of categorizing errors or identifying which checks failed). This matches anchor 4 rather than 3 (more than 1-2 actions) and falls short of 5 (not comprehensive).

4 / 5

Completeness

The description clearly answers both questions: what ("Diagnose a failed CI run: pull logs, isolate the failing step, plan the fix") and when (explicit "Trigger: CI red, check the pipeline" clause, so the missing-trigger cap at 3 does not apply). It sits above anchor 4 because the trigger guidance is explicit, but below anchor 5 because the trigger phrases are terse and lack the concrete variation coverage of the 5-star example.

4 / 5

Trigger Term Quality

"Trigger: CI red, check the pipeline" provides some relevant natural keywords, but misses common variations users would say such as "build failed", "tests failing", "checks are red", or "pipeline broken". This fits anchor 3 (some relevant keywords, missing common variations) rather than 4, whose keyword coverage is broader.

3 / 5

Distinctiveness Conflict Risk

CI failure diagnosis is a distinct niche with triggers ("CI red", "check the pipeline") unlikely to fire for unrelated skills. Minor overlap risk remains with closely related build/fix skills, matching anchor 4 rather than 5.

4 / 5

Total

15

/

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

YoizenSA/dev-ai-workflow

Path

ywai/skills/diagnose-ci-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.