# repair-skill

repair-skill audits existing Claude Code skills against reference specs to spot frontmatter flaws, missing permissions, and syntax gaps.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/repair-skill/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/repair-skill

## What it does

The skill accepts a target directory or direct path to a `SKILL.md` file. Before diagnosing anything, it checks sibling resource folders and pulls three internal guides covering skill anatomy, valid frontmatter keys, and false-positive calibration.

Evaluation runs across multiple dimensions. It flags third-person voice violations, token bloat in descriptions, and over-broad tool scopes like unconstrained `Bash`. It also suggests replacing tool calls with dynamic inline injections like `@$1` where appropriate. The explicit boundary holds: it fixes structural faults and missing pieces, but feature expansion belongs in `improve-skill`.

The routine halts immediately if reference documents inside `skills/repair-skill/references/` are unreadable.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-skills@Claudest
```
This installs the whole claude-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill repair-skill -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/repair-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/repair-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill repair-skill -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/repair-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill repair-skill -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/repair-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-skills/skills/repair-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/repair-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill repair-skill -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/skills/repair-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/repair-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-skills/skills/repair-skill/SKILL.md

## When to use it
- audit existing `SKILL.md` files against layout standards
- cut down frontmatter token overhead across sessions
- tighten tool scopes and eliminate dead entries in `allowed-tools`
- detect missing autocomplete hints for arguments

## Example prompts
- Audit this skill at ./plugins/claude-skills/skills/git-helper
- Fix my skill in ~/.claude/skills/extract-data
- Run diagnostics on ./SKILL.md

## Similar
- [agent-smith](https://affpapa.org/en/nevibecode/plugins/agent-smith.md) — plugin · ★ 8 repo stars
- [landmark-fit-repair](https://affpapa.org/en/nevibecode/skills/landmark-fit-repair.md) — skill · 1300 installs
- [fit-repair-optimizer](https://affpapa.org/en/nevibecode/skills/fit-repair-optimizer.md) — skill · 1300 installs
- [w-git-repair](https://affpapa.org/en/nevibecode/skills/w-git-repair.md) — skill · 647 installs
- [gke-ai-troubleshooting-tpu-vm-repair-stuck](https://affpapa.org/en/nevibecode/skills/gke-ai-troubleshooting-tpu-vm-repair-stuck.md) — skill · 431 installs
- [launcher_repair](https://affpapa.org/en/nevibecode/agents/launcher-repair.md) — subagent · ★ 395 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
