skill-repair

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

1|Updated Aug 30, 2026
One-click install
npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill skill-repair-feexsystems
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-repair
Source: https://github.com/FeexSystems/3WM-SONIK-LABS/tree/main/.gemini/skills/skill-repair
Command: npx skills add https://github.com/FeexSystems/3WM-SONIK-LABS --skill skill-repair-feexsystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent skills can fail to install due to malformed SKILL.md files, missing resources, or broken sub-scripts, leaving them stuck in an error state. This Skill provides a structured procedure to diagnose the failure, fix the installed files, and mark the skill as repaired in the manifest. ## Core Features & Use Cases - Error Diagnosis: Analyzes the reported installation error and inspects all files in the skill directory collectively to find the root cause. - Surgical Repair: Applies fixes directly at the installed path, covering malformed SKILL.md files, missing resources, and incorrect sub-scripts. - Manifest Synchronization: Updates the skill's entry in manifest.json by setting status to "installed" and clearing the error field so the UI refreshes automatically. - Use Case: A skill named "my-skill" fails installation with a parsing error. Use this Skill to locate the malformed frontmatter, fix it, and update manifest.json so the skill becomes active again. ## Quick Start Fix the broken skill that failed installation and update its manifest.json entry 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 an agent skill that failed installation?▼

Analyze the reported error, list all files in the skill's installed directory, and fix the root cause such as malformed SKILL.md frontmatter or missing resources. Then update manifest.json to set the skill's status to installed and clear the error field.

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

Find 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 detects this change automatically and refreshes.

What causes agent skill installation to fail?▼

Common causes include malformed SKILL.md files with invalid YAML frontmatter, missing resource files referenced by the skill, and incorrect or broken sub-scripts. Inspecting all files in the skill directory collectively helps identify the root cause.

Why is my skill still showing an error after I fixed the files?▼

The manifest.json entry still contains the old error state. You must update the skill's entry to set status to "installed" and clear the error field, otherwise the UI continues to display the failure.

Should I fix the skill at the source path or installed path?▼

Fixes are applied at the installed path where the skill is replicated. Because skills can contain multiple files, list and analyze all of them together before applying the fix to every relevant file.