# repair-agent

repair-agent runs an existing agent file through seven dimensions, reports what is broken and what is missing, then hands back a plan of edits.

- 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-agent/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-agent

## What it does

It takes the path to a Claude agent file, reads the whole thing and checks it against seven dimensions. Those include the description that decides whether the router picks the agent at all, the frontmatter fields, and the voice of the system prompt. Each finding gets a tag — violation, gap or improvement — and a severity level. Where `create-agent` writes an agent from nothing, this one inspects what you already have.

Two references are loaded before the audit starts, both from `${CLAUDE_PLUGIN_ROOT}`: `agent-anatomy.md` for the target prompt structure and `agent-frontmatter.md` from `create-agent` for the field catalog. The result is a structured plan of edits rather than a bare list of complaints.

The path arrives as `<path-to-agent-file>`. A `SKILL.md` or anything under `skills/` is declined outright and sent to `repair-skill`, since only agents are in scope here.

## 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-agent -a claude-code
```

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/repair-agent/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-agent
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/repair-agent/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-agent/SKILL.md

## When to use it
- find broken frontmatter fields in an agent file
- check whether an agent description will trigger routing
- strip first-person phrasing from a system prompt
- cut bloated description text that eats context on every spawn
- get an edit plan across all seven dimensions

## Example prompts
- Audit the agent at `<path-to-agent-file>` and tell me what is broken and what is missing.
- Review the quality of my agent and suggest what to tighten.
- Diagnose problems in this agent file and put together a plan of fixes.

## Similar
- [audit-subagent](https://affpapa.org/en/nevibecode/commands/audit-subagent.md) — command · ★ 1988 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
