heal-skill

Diagnose SKILL.md misconfigurations and apply approved fixes with diffs.

50|14|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/All-The-Vibes/ATV-StarterKit --skill heal-skill-all-the-vibes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/All-The-Vibes/ATV-StarterKit/tree/main/.github/skills/heal-skill
Command: npx skills add https://github.com/All-The-Vibes/ATV-StarterKit --skill heal-skill-all-the-vibes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fix incorrect SKILL.md files when a skill has wrong instructions or outdated API references.

Core Features & Use Cases

  • Detect misconfigurations in SKILL.md frontmatter and body.
  • Propose precise fixes with before/after diffs and impact notes.
  • Apply changes to SKILL.md and related references/scripts after user approval.

Quick Start

Run the Heal Skill to detect and repair a misconfigured SKILL.md, preview the changes, and apply them after your approval.

Frequently Asked Questions about heal-skill

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

FAQPage Schema
How do I fix incorrect SKILL.md frontmatter and outdated instructions?

The Heal Skill diagnoses misconfigurations in SKILL.md frontmatter and body, then proposes precise fixes with before/after diffs. You review the impact notes and approve the changes before they are applied to the file and related scripts.

How do I preview changes before applying fixes to a SKILL.md file?

You preview changes by reviewing the before/after diffs and impact notes generated by the diagnostic process. The system awaits your explicit approval before applying any modifications to the SKILL.md and related references.

Can I automatically update related scripts and references when fixing SKILL.md?

Yes, after you approve the proposed diffs, the healing process applies changes to both the SKILL.md file and its related references or scripts, optionally generating a commit message to track the version-controlled updates.

What causes a SKILL.md file to have misconfigurations or wrong instructions?

Misconfigurations occur when the frontmatter and body contain outdated API references or invalid syntax. The diagnostic process identifies these specific structural and content issues by deeply analyzing the SKILL.md file.

Does the SKILL.md repair process support version control and commit messages?

Yes, the SKILL.md repair process supports version control by optionally generating a commit message. When you approve the before/after diffs, the system applies the changes to the file and related scripts, providing a commit message for tracking.