skill-repair

Analyze the reported error, then list all files in the skill's installed directory and inspect them collectively to find the root cause, such as malformed SKILL.md or missing resources. After fixing every affected file, update manifest.json to set the skill's status to installed and clear the error field.

Locate the skill's entry by its ID inside the skills object in manifest.json. Set the status field to "installed" and set the error field to null or remove it entirely. The UI detects this change automatically and refreshes.

Common causes include malformed SKILL.md frontmatter, missing resource files referenced by the skill, and incorrect or broken sub-scripts. Because skills can contain multiple files, all files in the directory should be analyzed together to identify the root cause.

The error persists if manifest.json was not updated after the fix was applied. The skill's entry must have status set to "installed" and the error field cleared to null, otherwise the UI continues displaying the failed state.

All relevant files must be fixed, not just the one mentioned in the error message. Skills often span multiple files, so the repair procedure requires listing every file in the skill directory and analyzing them collectively before updating the manifest.