ultraqa

Run goal-driven QA cycles to fix failing tests, builds, lint, or type checks.

Updated May 5, 2026
One-click install
npx skills add https://github.com/HyperionBurn/searchv1beta --skill ultraqa-hyperionburn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ultraqa
Source: https://github.com/HyperionBurn/searchv1beta/tree/main/.github/skills/ultraqa
Command: npx skills add https://github.com/HyperionBurn/searchv1beta --skill ultraqa-hyperionburn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of getting a project to a passing quality state when tests, lint, or type checks fail, by repeatedly running QA, diagnosing failures, applying fixes, and retrying until the chosen goal is met.

Core Features & Use Cases

  • Goal-driven QA cycles: Run checks based on a specific target like --tests, --build, --lint, or --typecheck, instead of doing a one-off run.
  • Iterative diagnose-and-fix loop: Detect failure results, route analysis to an architect step, apply corrections via an executor step, and repeat.
  • Guardrails and state tracking: Enforces a maximum of 5 cycles, supports early exit on repeating failures, and tracks progress in .omg/ultraqa-state.json for resumable behavior.

Quick Start

Run the ultraqa workflow in interactive mode to keep cycling until all tests pass.

Frequently Asked Questions about ultraqa

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

FAQPage Schema
How do I automate fixing failing tests and lint errors in my codebase?

Automated test fixing uses a goal-driven QA cycling loop that repeatedly runs verification, diagnoses root causes, applies corrections, and retries until checks pass. You select a goal like tests, build, lint, or typecheck to start the iterative diagnose-and-fix loop.

What is a self-healing QA cycle for build verification and type checks?

A self-healing QA cycle is an iterative loop that detects failures, routes analysis to an architect step, applies fixes via an executor step, and repeats. It enforces a maximum of five cycles and tracks progress in a state file for resumable behavior.

Can I run linting and typecheck fixes separately from test automation?

Yes, you can run linting and typecheck fixes separately by selecting a specific target. The goal-driven QA cycles support distinct selectable goal types including tests, build, lint, and typecheck, allowing you to target only the failing checks you need.

Does the automated debugging loop stop if the same test failures keep repeating?

Yes, the automated debugging loop stops if the same failures keep repeating. It enforces early exit conditions on repeating failures and limits the entire process to a maximum of five cycles to prevent infinite loops.

How do I resume an interrupted CI fix cycle after closing my terminal?

You resume an interrupted CI fix cycle through persisted state tracking. The process saves progress automatically in a local state file, allowing the deterministic success or failure conditions to resume from where the previous iteration left off.

Why does my automated test runner exit before reaching a passing quality state?

An automated test runner exits before reaching a passing state when it hits the maximum of five cycles or encounters repeating failures. These deterministic exit conditions prevent infinite loops when analysis and remediation cannot resolve the root cause.