repair-agent — Claude Code skill: audit and fix your agents
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.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@ClaudestWhat repair-agent 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.
What it helps with
- 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 for the agent
- 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.
How to install repair-agent
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-skills@ClaudestThis installs the whole claude-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-agent -a claude-code3Manually: put the files in place
~/.claude/skills/repair-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/repair-agent/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-agent -a codex2Manually: put the files in place
.agents/skills/repair-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-agent -a cursor2Manually: put the files in place
.cursor/skills/repair-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-skills/skills/repair-agent2Manually: put the files in place
.github/skills/repair-agent/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/skills/repair-agentManually: put the files in place
.devin/skills/repair-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about repair-agent
How do I install repair-agent in Claude Code?
Add the marketplace with /plugin marketplace add gupsammy/Claudest, then install the plugin: /plugin install claude-skills@Claudest.
What does repair-agent do?
It reads an existing agent file and checks it across seven dimensions, covering the description, frontmatter fields, prompt voice and the rest. You get a structured plan of edits back.
Does it work on skills too?
No. A SKILL.md or a path inside skills/ is turned down and pointed at repair-skill, which handles those.