heal

Diagnose failures and route them to Dev, Architect, or PO experts.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/antoinersw/pbi-versioning --skill heal-antoinersw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal
Source: https://github.com/antoinersw/pbi-versioning/tree/main/.claude/skills/heal
Command: npx skills add https://github.com/antoinersw/pbi-versioning --skill heal-antoinersw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auto-diagnoses failures across tests, type checks, builds, and spec gaps, and routes each issue to the correct domain expert (Dev, Architect, or PO) to accelerate repair cycles. It minimizes handoffs and orchestrates an autonomous repair loop with QA verification until green.

Core Features & Use Cases

  • Smart routing by issue type to the appropriate expert (e.g., test failures to Dev, type errors to Architect, spec gaps to PO).
  • Autonomous fix loop with agent coordination and QA verification until the issue is resolved.
  • Context persistence via .clean-claude to resume work after interruptions and continue from where you left off.
  • Mode-aware operation: supports full flow (with PO involvement) and craft-the-existing refactor mode.
  • Covers code and spec healing workflows, including tests, builds, types, lint, and spec drift.

Quick Start

Run /heal to begin diagnosing failures and automatically heal code, tests, and specs by routing to the right experts.

Frequently Asked Questions about heal

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

FAQPage Schema
How do I automate routing test failures and type errors to the right team members?

Automate routing test failures and type errors by diagnosing issues and directing them to the appropriate domain expert, such as Dev, Architect, or PO. This minimizes handoffs and accelerates the repair cycle by coordinating the correct expert fixes immediately.

What is an autonomous repair loop for software diagnostics?

An autonomous repair loop for software diagnostics automatically identifies issues across tests, builds, and spec gaps, routes them to experts, and verifies QA until the issue is resolved. It orchestrates the entire fix cycle continuously until tests pass green.

How do I fix spec drift and code gaps in my project?

Fix spec drift and code gaps by running an automated diagnostic tool that routes these discrepancies to the Product Owner or Architect. It coordinates the necessary code and spec healing workflows to realign the project requirements and implementation.

Can I resume an interrupted code repair loop from where it left off?

Yes, you can resume an interrupted code repair loop because the system persists context in a .clean-claude file. This allows the autonomous repair process to continue from the exact point of interruption without losing previous diagnostic progress.

Does automated failure routing support refactor mode for existing codebases?

Yes, automated failure routing supports a craft-the-existing refactor mode alongside the full flow mode. This mode-aware operation allows you to apply automated diagnostics and expert routing specifically to refactoring tasks within existing code.

What is the best way to coordinate expert fixes with QA verification?

The best way to coordinate expert fixes with QA verification is using an autonomous routing system that directs failures to Dev, Architect, or PO, then orchestrates a loop applying fixes and running verification checks until the build is green.