skill-repair

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

Locate the skill's entry in the skills object of manifest.json, set its status field to installed, and set the error field to null or remove it. The UI detects this change automatically and refreshes the skill state.

Common causes include malformed SKILL.md frontmatter, missing resource files, and incorrect sub-scripts within the skill directory. Because skills can contain multiple files, all files must be inspected collectively to identify the actual root cause.

The skill remains in an error state until manifest.json is updated to reflect the repair. You must set the status to installed and clear the error field for the UI to detect the change and refresh.

Only if a single file is the confirmed root cause. The repair procedure requires listing and analyzing all files in the skill directory collectively, since failures can span multiple files such as the SKILL.md and its sub-scripts.