skills.rest
marchatton
marchattonCOMMUNITY
Explore all skills by this author →
Website𝕏@marchattonhereGitHub

heal-skill

Correct SKILL.md files and related skill resources after user approval.

5|Updated Oct 22, 2025
Search Tags:#automation#debugging#agent skills#configuration#skill maintenance#error correction
One-click install
npx skills add https://github.com/marchatton/agent-skills --skill heal-skill-marchatton
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/marchatton/agent-skills/tree/main/.agents/skills/98-skill-maintenance/heal-skill
Command: npx skills add https://github.com/marchatton/agent-skills --skill heal-skill-marchatton

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses issues with incorrectly configured or outdated Skill Units, ensuring they function as intended by automatically detecting and correcting errors in their SKILL.md files and related documentation.

Core Features & Use Cases

  • Automated Skill Diagnosis: Identifies and analyzes errors within a skill's SKILL.md and associated files.
  • Proactive Correction: Proposes specific, diff-based fixes for identified issues.
  • User-Guided Application: Requires explicit user approval before applying any changes, ensuring control and preventing unintended modifications.
  • Use Case: If a skill fails to load due to a typo in its SKILL.md or an outdated API reference, this skill can pinpoint the error, suggest the correction, and apply it after your confirmation.

Quick Start

Use the heal-skill to fix any detected errors in the current skill's configuration.

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 agent skills with outdated instructions?▼

Fixing broken agent skills involves analyzing execution errors and outdated instructions in SKILL.md files, proposing diff-based corrections, and applying updates after explicit user approval.

Why does my skill fail to load due to a typo in SKILL.md?▼

Skills fail to load due to typos or outdated API references in SKILL.md files. Automated diagnosis pinpoints the configuration error and proposes specific corrections to restore functionality.

Can I automatically update skill unit resources without manual review?▼

No, you cannot automatically update skill unit resources without manual review. The system requires explicit user approval before applying any proposed file modifications to ensure configuration integrity.

What is the best way to maintain skill integrity in an agentic framework?▼

Maintaining skill integrity requires proactive correction of detected execution errors by analyzing root causes and proposing specific file modifications to ensure operational accuracy within an agentic framework.

Does the skill correction process provide before and after diffs?▼

Yes, the skill correction process provides before and after diffs. It reflects on the root cause of the issue and proposes specific file modifications using diff-based formatting for clear review.

Related Skills

Explore More Software Engineering Skills→
typemdtypemd
9

skill-retro

Analyze skill execution logs to catalog corrections and update SKILL.md files.

Official
Intermediate
All-The-VibesAll-The-Vibes
50

heal-skill

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

Official
Advanced
RedKenrokRedKenrok
1

writing-skill-md

Validate SKILL.md frontmatter and structure for Skill Units.

Community
Basic
udecodeudecode
240

heal-skill

Correct errors in SKILL.md files by fixing outdated API references and instructions.

Official
Intermediate