skills.rest
jerrylin96
jerrylin96COMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-repair

Fix broken agent skill installations and update manifest.json status entries.

9|Updated Jul 8, 2026
Search Tags:#troubleshooting#agent skills#frontmatter#manifest.json#skill repair#installation error
One-click install
npx skills add https://github.com/jerrylin96/dotgemini --skill skill-repair-jerrylin96
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-repair
Source: https://github.com/jerrylin96/dotgemini/tree/main/skills/skill-repair
Command: npx skills add https://github.com/jerrylin96/dotgemini --skill skill-repair-jerrylin96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent skills can fail installation due to malformed SKILL.md files, missing resources, or broken sub-scripts, leaving them stuck in an error state. This Skill provides the context and procedure to diagnose the failure, repair the installed files, and mark the skill as installed again. ## 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: Guides fixes at the installed path, covering malformed SKILL.md frontmatter, missing resources, and incorrect sub-scripts. - Manifest Update: 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 fails to install because its SKILL.md has invalid YAML frontmatter. Use this Skill to locate the file, correct the frontmatter, and update manifest.json so the skill becomes available 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?▼

Inspect all files in the skill's installed directory to find the root cause, such as malformed SKILL.md frontmatter or missing resources. After applying the fix, update manifest.json by setting the skill's status to installed and clearing its 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 and refreshes automatically.

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. Listing and analyzing all files in the skill directory collectively helps identify the root cause.

Why does a repaired skill still show an error status?▼

The manifest.json entry was likely not updated after the fix. The status field must be set to installed and the error field cleared, otherwise the UI continues displaying the previous failure state.

Related Skills

Explore More Software Engineering Skills→
Lathika-laaLathika-laa

skill-repair

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

Community
Intermediate
fabioc-alohafabioc-aloha
1

agent-debug-panel

Diagnoses agent, skill, and hook loading and execution issues in real-time.

Community
Intermediate
DingJun1028DingJun1028

skill-repair

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

Community
Intermediate
OpenDCAIOpenDCAI
114

sksgrm

Delete a skill group and its associated skills from the .claude/skill-groups directory.

Official
Basic