skills.rest
tottenjordan
tottenjordanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-repair

Fixes failed agent skill installations and updates manifest.json status entries.

1|Updated Mar 19, 2026
Search Tags:#troubleshooting#agent skills#installation#error fixing#manifest.json#skill repair
One-click install
npx skills add https://github.com/tottenjordan/me-skittles --skill skill-repair-tottenjordan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-repair
Source: https://github.com/tottenjordan/me-skittles/tree/main/gemini/skill-repair
Command: npx skills add https://github.com/tottenjordan/me-skittles --skill skill-repair-tottenjordan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent skills that fail installation leave broken files and error states in the manifest.json, blocking their use. This Skill guides the repair of the failed skill's source files and ensures the manifest is correctly updated so the UI recognizes the skill as installed again. ## Core Features & Use Cases - Error Analysis and Repair: Diagnoses reported installation errors and fixes root causes across all files in the skill directory, including malformed SKILL.md files, missing resources, or broken sub-scripts. - Manifest Synchronization: Updates the skill's entry in manifest.json by setting status to "installed" and clearing the error field after the fix is applied. - Use Case: A skill fails to install due to a malformed SKILL.md. Use this Skill to inspect every file in the skill directory, correct the frontmatter, and update manifest.json so the UI refreshes and shows the skill as installed. ## Quick Start Fix the failed skill installation for the given skill ID, repair its source files, and update manifest.json to mark it as installed.

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 failed agent skill installation?▼

Analyze the reported error, then list and inspect 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.

How do I update manifest.json after repairing a skill?▼

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

Why does a skill fail to install?▼

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

Does the UI refresh automatically after a skill repair?▼

Yes. Once manifest.json is updated with the status set to installed and the error cleared, the UI automatically detects the change and refreshes without further manual steps.

What are the limitations of this repair approach?▼

The repair depends on the accuracy of the reported error message and requires access to the skill's installed path and manifest path. It fixes file-level issues but does not reinstall dependencies or modify skills outside the targeted skill directory.

Related Skills

Explore More Software Engineering Skills→
ollieb89ollieb89

skill-installer

Install Codex skills from curated sources or GitHub repositories.

Community
Intermediate
RxFitRxFit

skill-repair

Repair failed agent skills by updating manifest.json to corrected status.

Community
Intermediate
luongnv89luongnv89
787

metadata-author-present-pass

Validate name and description fields in SKILL.md frontmatter.

Community
Basic
ironkid90ironkid90

skill-repair

Repair broken agent skills by updating manifest.json and verifying changes.

Community
Intermediate