heal-skill

Diagnose and auto-repair broken skills with user-confirmed fixes.

28|3|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/ScientiaCapital/skills --skill heal-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/ScientiaCapital/skills/tree/main/active/heal-skill
Command: npx skills add https://github.com/ScientiaCapital/skills --skill heal-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and repair broken skills in a skills library. It validates YAML frontmatter, XML sections, and config.json schema, and can auto-fix issues with user confirmation.

Core Features & Use Cases

  • Structural validation of SKILL.md frontmatter and required fields.
  • Content quality checks for XML sections, line counts, and dead reference links.
  • Integrated auto-fix workflow with previews and user confirmation, plus library-wide health scoring.

Quick Start

Run /heal-skill to scan the entire library, or /heal-skill <name> to diagnose a single skill, then review and approve any auto-fixes.

Frequently Asked Questions about heal-skill

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

FAQPage Schema
How do I validate YAML frontmatter and config.json schema in a skills library?

To validate YAML frontmatter and config.json schema, you can run a diagnostic scan across your entire skills library or target an individual skill to check required fields, enforce standard config keys, and identify structural issues.

What is the best way to auto-fix broken skill files and missing XML sections?

The best way to auto-fix broken skill files is to run a diagnostic command that detects missing XML sections and invalid frontmatter, then apply safe automated repairs after previewing the proposed changes and confirming them.

How does a skill health check score the quality of a skills library?

A skill health check scores library quality by validating YAML frontmatter fields, verifying required XML section presence, checking line counts, detecting dead reference links, and enforcing config.json schema compliance across all files.

Can I diagnose a single broken skill without running a scan on the entire library?

Yes, you can diagnose a single broken skill by passing the specific skill name to the diagnostic command, which isolates the validation of frontmatter, XML sections, and config.json schema to that individual file.

What should I do if my config.json schema validation fails for a skill?

If your config.json schema validation fails, review the diagnostic output to identify missing or non-standard keys, then approve the suggested auto-fixes to enforce standard configuration requirements and restore the file.

Are auto-fixes applied immediately when structural validation finds missing XML sections?

No, auto-fixes for missing XML sections are not applied immediately; the tool generates a preview of the required structural repairs and waits for your explicit confirmation before modifying the skill files.