heal-skill

Detect and fix misconfigured SKILL.md files with user-approved diffs.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/The-Rabak/naysmith --skill heal-skill-the-rabak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/The-Rabak/naysmith/tree/main/.github/skills/heal-skill
Command: npx skills add https://github.com/The-Rabak/naysmith --skill heal-skill-the-rabak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fix incorrect SKILL.md files when a skill has wrong instructions or outdated API references, ensuring consistent discovery and safe execution.

Core Features & Use Cases

  • Detect misconfigurations in SKILL.md frontmatter and body
  • Propose precise before/after changes with diffs
  • Apply corrections after user approval, updating related references if needed
  • Validate cross-file consistency across skill units to prevent drift

Quick Start

Provide the current Skill context; the healer will detect the misconfigurations, propose fixes, and await your approval to apply changes.

Frequently Asked Questions about heal-skill

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

FAQPage Schema
How do I fix misconfigured SKILL.md files and outdated API references?

To fix misconfigured SKILL.md files, you can use a healing workflow that detects issues in frontmatter and body content, presents before/after diffs, and applies corrections after your approval to maintain safe execution.

What is skill maintenance and when do I need to validate cross-file consistency?

Skill maintenance is the process of detecting and correcting outdated API references and misconfigurations. You need to validate cross-file consistency to prevent configuration drift across related files within a skill unit.

How do I preview YAML diff changes before applying updates to a skill definition?

You can preview YAML diff changes by running a validation process that identifies misconfigurations in SKILL.md frontmatter, proposes precise before/after changes, and waits for your explicit approval before applying any updates.

Can I automate validation for outdated API references without manual intervention?

Automation can detect outdated API references and misconfigurations across skill units, but applying corrections requires user approval to ensure safety and prevent unintended drift across related files.

Why does my skill discovery fail when SKILL.md has incorrect instructions?

Skill discovery fails because incorrect instructions in SKILL.md disrupt consistent indexing and safe execution. Healing the file by proposing targeted diffs and applying approved changes restores proper validation and consistency.

What are the limitations of healing misconfigured skill definitions?

Healing misconfigured skill definitions requires providing the current skill context for accurate detection, and changes are only applied after explicit user approval, meaning fully autonomous correction without review is not supported.