skill-repair

Repair broken agent skill installations by fixing files and updating manifests.

Updated Jun 10, 2026
One-click install
npx skills add https://github.com/AubreyHan/SKILL_Repo --skill skill-repair-aubreyhan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-repair
Source: https://github.com/AubreyHan/SKILL_Repo/tree/main/skill-repair
Command: npx skills add https://github.com/AubreyHan/SKILL_Repo --skill skill-repair-aubreyhan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps repair broken agent skills that failed installation so they can be restored and used again without manual guesswork.

Core Features & Use Cases

  • Root-cause repair: Reviews the skill files together to find malformed metadata, missing resources, or script issues.
  • Manifest recovery: Updates the manifest after fixes so the repaired skill is marked installed again.
  • Use case: Use it when a skill install fails because the entry file is invalid, a reference file is missing, or the status needs to be cleared after a patch.

Quick Start

Use the skill repair assistant to analyze the reported installation error, fix the affected skill files, and update the manifest status.

Frequently Asked Questions about skill-repair

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

FAQPage Schema
How do I fix a broken agent skill that failed installation?

To fix a broken agent skill installation, you need to repair malformed metadata, missing reference files, or invalid entry scripts. This skill analyzes the bundled skill directory to coordinate source-file fixes and clear the error state.

Why does my agent skill installation fail due to invalid metadata?

Agent skill installation fails due to invalid metadata when manifest files are malformed or missing required resources. The repair process reviews all skill files together to identify root-cause issues and apply coordinated fixes to restore functionality.

What's the best way to restore a failed skill to working state?

The best way to restore a failed skill is to use a repair assistant that analyzes the reported installation error, fixes affected skill files, and updates the manifest status. This marks the skill as installed and clears the error state.

Can I update the manifest manually after repairing a broken skill installation?

Yes, you can update the manifest manually after repairing a broken skill installation, but a coordinated repair process is recommended. This ensures source-file fixes and manifest updates are synchronized so the skill is properly marked installed.

Do I need to fix missing reference files before clearing the skill installation error state?

Yes, you need to fix missing reference files before clearing the skill installation error state. The repair process requires coordinated source-file fixes and manifest updates so the skill is marked installed and its error state is fully cleared.

When do I need to repair a bundled skill directory?

You need to repair a bundled skill directory when an installation error occurs and the directory contains malformed metadata, missing resources, or script issues. This repair applies to supporting files that failed during the initial installation.