ci-failure-triage

name	ci-failure-triage
description	Diagnoses CI/CD failures from logs and workflow files, identifies likely root cause, and recommends minimal fixes or retry guidance.

CI Failure Triage

Use this skill when a CI or deployment job fails and the user provides logs, workflow files, or job metadata.

Inputs

• CI logs, failing job and step names, workflow YAML, recent commits, dependency changes, and environment details

Steps

1. Locate the first failing step and first meaningful error.
2. Classify the failure: test regression, build error, dependency resolution, cache issue, credentials/permissions, environment drift, rate limit, flaky test, or deployment failure.
3. Compare the failing step to workflow configuration and recent changes.
4. Identify whether retrying is reasonable or whether a code/config fix is required.
5. Recommend the smallest fix and any workflow hardening that prevents recurrence.
6. Provide commands or workflow rerun steps when appropriate.

Output

Return:

• Failure classification
• Root cause hypothesis with evidence
• Minimal fix plan
• Retry guidance
• Preventive hardening suggestions

Guidelines

• Do not focus on the last error if earlier setup failed.
• Be explicit when logs are insufficient.
• Separate likely root cause from secondary noise.