heal-skill

Correct errors in SKILL.md files with user-approved modifications.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard --skill heal-skill-jimmychen-nxp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heal-skill
Source: https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard/tree/main/.github/skills/heal-skill
Command: npx skills add https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard --skill heal-skill-jimmychen-nxp

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 SKILL.md files and associated skill resources, ensuring skills function as intended.

Core Features & Use Cases

  • Automated Skill Repair: Detects and fixes incorrect instructions, outdated API references, or logical flaws in SKILL.md.
  • Contextual Analysis: Analyzes conversation history and skill invocation to pinpoint the exact issue.
  • User-Guided Correction: Proposes specific changes with before/after diffs and requires user approval before applying.
  • Use Case: If a skill fails due to a malformed API call defined in its SKILL.md, this skill can analyze the failure, identify the incorrect parameter, and propose a corrected version for user approval.

Quick Start

Use the heal-skill to fix the SKILL.md file 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.md files with outdated API references?

To fix broken SKILL.md files, automated skill repair tools detect and correct outdated API references, incorrect instructions, and logical flaws. They analyze conversation context to pinpoint exact issues, then propose specific before/after diffs for user approval before applying modifications.

Why does my AI agent skill fail due to logical flaws in the skill definition?

AI agent skills fail due to logical flaws when SKILL.md files contain malformed API calls or incorrect parameters. Contextual analysis of conversation history and skill invocation identifies the exact failure point, allowing targeted correction of the flawed skill definition through user-approved modifications.

What's the best way to automate code correction for malformed skill definitions?

Automating code correction for skill definitions requires an AI agent that detects errors in SKILL.md files and proposes updates. The process analyzes conversation history to identify incorrect parameters, generates corrected versions with before/after diffs, and applies changes only after explicit user approval.

Can I update SKILL.md files without manually rewriting the entire skill resource?

Updating SKILL.md files without manual rewriting is possible through user-guided correction. The system proposes specific changes with before/after diffs based on detected errors, requiring user approval before applying targeted modifications to the skill definition and associated resources.

Does automated skill repair work for debugging incorrect instructions in SKILL.md?

Automated skill repair works for debugging incorrect instructions by analyzing conversation context and skill invocation data. It identifies the specific error within the SKILL.md file, proposes a corrected instruction set, and applies the fix only after the user reviews and approves the suggested modification.

When should I not use an AI agent for skill repair on SKILL.md files?

You should not use an AI agent for skill repair when SKILL.md files require complex architectural changes beyond isolated API references or logical flaws. The tool targets specific detected errors through user-approved modifications, making it unsuitable for complete skill redesigns or structural rewrites.