qlty-transient-build-error

Diagnoses Qlty Cloud build failures and re-triggers aborted analysis runs with one empty commit.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill qlty-transient-build-error-vilnacrm-org
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qlty-transient-build-error
Source: https://github.com/VilnaCRM-Org/claude-plugins/tree/main/plugins/react-frontend-sdlc/skills/qlty-transient-build-error
Command: npx skills add https://github.com/VilnaCRM-Org/claude-plugins --skill qlty-transient-build-error-vilnacrm-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A Qlty check can report a red failure status with "Build errored. Check the log for more information." while its inline analysis comment shows no findings, leaving you unsure whether your code is broken or Qlty Cloud itself had an outage. This Skill separates transient infrastructure failures from real code defects so you do not waste time fixing code that is not broken. ## Core Features & Use Cases - Failure-mode triage: Distinguishes four verdicts (real crash, real findings, candidate outage, unknown) by reading the cloud build log rather than trusting the status text, which is identical across all cases. - Single evidence-backed retry: Re-triggers the cloud analysis with one empty commit whose header satisfies commitlint's type(#N): subject format, capped at one attempt before escalating. - Repository-shape awareness: Documents applicability across React SPA, Next.js app, and component-library shapes based on how .qlty/qlty.toml is tracked. - Use Case: Your pull request shows every required check green except Qlty, which failed in near-zero time with a clean inline comment. Use this Skill to inspect the build log, confirm a pipeline abort, and push one conforming empty commit to re-run the analysis. ## Quick Start Check whether the failing Qlty status on my pull request is a transient cloud outage and re-trigger the analysis once if it is.

Frequently Asked Questions about qlty-transient-build-error

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a Qlty check that says build errored?▼

Open the Qlty cloud build log first, since the status text is identical for every failure mode. If the log shows no tool output and the pipeline aborted, push one empty commit with a commitlint-conforming header like ci(#N) to re-trigger the analysis.

Why does Qlty fail but show no findings in its comment?▼

This mismatch means either Qlty Cloud had an infrastructure outage or a linter crashed at rule-load time before producing output. The build log separates the two: linter stderr indicates a real crash, while no tool output indicates a candidate outage.

How many times should I retry a failed Qlty cloud build?▼

Retry exactly once with an empty commit. If the second run reports the same failure status, the cause is not transient, so read the log and treat what it shows as the actual defect instead of pushing again.

Why was my empty retrigger commit rejected by the commit hook?▼

The commit-msg hook enforces commitlint, which requires a type(#N): subject header with a real task number. A bare retrigger message is rejected, so write a conforming header such as ci(#N): re-run the cloud analysis build rather than bypassing the hook.

When should I not retry a failing Qlty check?▼

Do not retry when the build log contains linter stderr or a stack trace, since that indicates a runtime-version mismatch fixed by pinning, not by retrying. Also avoid retrying when the log lists actual findings, which require code fixes.