heal

Automates diagnosis and repair of code and specification issues across a software project.

13|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/fredericvilcot/clean-claude --skill heal-fredericvilcot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal
Source: https://github.com/fredericvilcot/clean-claude/tree/main/.claude/skills/heal
Command: npx skills add https://github.com/fredericvilcot/clean-claude --skill heal-fredericvilcot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically diagnoses and fixes issues in code (tests, types, build, lint) and specifications, ensuring your project stays robust and aligned.

Core Features & Use Cases

  • Automated Debugging: Detects and resolves common coding errors without manual intervention.
  • Intelligent Routing: Directs problems to the correct agent (Dev, Architect, PO, DevOps) for efficient fixing.
  • Spec Synchronization: Identifies and resolves discrepancies between specifications and implementation.
  • Use Case: After a /craft command fails due to failing tests, /heal can automatically re-run the relevant agents to fix the tests and continue the development loop.

Quick Start

Use the heal skill to automatically detect and fix any broken tests or type errors in the project.

Frequently Asked Questions about heal

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

FAQPage Schema
How do I automatically fix TypeScript errors and failing tests in my project?

Automated debugging tools detect test failures, type errors, and build errors, then intelligently route them to the appropriate expert agent for autonomous resolution. The system re-runs verification loops until all issues are fixed.

What is spec-implementation drift and how can I resolve it automatically?

Spec-implementation drift happens when your code diverges from project specifications. Auto-repair tools identify these discrepancies and route them to the appropriate agent for autonomous synchronization and resolution.

How do I set up CI/CD auto-repair for linting and build errors?

CI/CD auto-repair for linting and build errors routes detected problems to DevOps or development agents for autonomous resolution. The system continuously re-runs diagnostics until all issues are resolved or retries are exhausted.

Can I use automated debugging to fix code without manual intervention?

Yes, automated debugging can resolve code issues without manual intervention by intelligently routing test failures, type errors, and linting issues to expert agents. It autonomously re-runs diagnostics until all problems are fixed.

What happens when auto-repair reaches maximum retries on unresolved code issues?

When auto-repair reaches maximum retries, the automated verification loop terminates. The system stops routing issues to expert agents and exits the repair cycle, ensuring the process does not run indefinitely.