heal-skill

Apply user-approved corrections to skill documentation with diffs.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/royhenengel/Claude-Customizations --skill heal-skill-royhenengel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/royhenengel/Claude-Customizations/tree/main/skills/Tooling/heal-skill
Command: npx skills add https://github.com/royhenengel/Claude-Customizations --skill heal-skill-royhenengel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically identifies and corrects errors within other Skills' documentation and code, ensuring they function as intended.

Core Features & Use Cases

  • Automated Skill Diagnosis: Analyzes conversation context to pinpoint the currently running skill and identify issues.
  • Correction Proposal: Generates specific, before-and-after diffs for proposed fixes in SKILL.md and related files.
  • User-Guided Approval: Requires explicit user confirmation before applying any changes, ensuring control.
  • Use Case: If a skill fails due to an incorrect API endpoint in its SKILL.md, this skill can detect the error, propose the correct endpoint, and apply the fix after your approval.

Quick Start

Use the heal-skill to fix the documentation for the 'data-analysis' skill.

Frequently Asked Questions about heal-skill

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

FAQPage Schema
How do I fix broken skill documentation after an execution error?

To fix broken skill documentation, you can use an automated healing process that analyzes conversation context to detect errors and propose specific before-and-after diffs for your SKILL.md files. It applies the corrections after you explicitly approve the changes.

Can I automatically correct code and documentation errors in my skills?

Yes, you can automatically correct code and documentation errors by reflecting on execution failures to pinpoint the running skill. The system generates targeted fixes with specific diffs and applies them through a user-guided approval workflow.

How does automated skill healing work when a skill fails?

Automated skill healing works by analyzing the conversation context to identify the currently running skill, reflecting on the encountered errors, and proposing specific fixes with diffs for your documentation and code before applying changes.

Do I need to manually approve code corrections during the skill healing process?

Yes, you need to manually approve code corrections during the skill healing process. The system requires explicit user confirmation before applying any changes to your SKILL.md and related files, ensuring you maintain full control over the modifications.

What is the best way to update an incorrect API endpoint in a skill file?

The best way to update an incorrect API endpoint in a skill file is to use a healing skill that detects the error during execution, proposes the correct endpoint with a before-and-after diff, and applies the fix after your approval.

What file system tools are required to diagnose and heal a skill?

Diagnosing and healing a skill requires tools for file system interaction and code editing to read the documentation, generate proposed diffs, and apply the approved corrections to the SKILL.md and related files.