Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@Claudest
Open on GitHub

What 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@Claudest

This installs the whole claude-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill repair-agent -a claude-code

3Manually: put the files in place

~/.claude/skills/repair-agent/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/repair-agent/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set47

The whole set →
create-skill create-skill guides Claude Code through building a skill or slash command by clarifying its purpose and activation scenarios. Use it to draft a new instruction file. CX Codex +1 ★ 276repo stars security-auditor security-auditor finds exploitable vulnerabilities in auth, untrusted-input handling, secrets, and dependencies. Triggered after changes to auth, API endpoints, or file operations. CX Codex ★ 276repo stars create-agent create-agent generates configured subagent markdown files for Claude Code with frontmatter and system prompts. CX Codex +1 ★ 276repo stars create-claw-skill create-claw-skill is a Claude Code skill for creating OpenClaw skills or slash commands and adapting Claude Code skills. It helps prepare a SKILL.md with platform-specific fields and instructions. CX Codex +1 ★ 276repo stars setup-github-actions setup-github-actions generates repository GitHub Actions pipelines wired to the Anthropic runner with least-privilege permissions. CX Codex +1 ★ 276repo stars generate-image generate-image — a Claude Code skill that creates and edits images through generate.py — logos, stickers, product mockups, t2i, i2i and multi-reference composites. It kicks in when you need a finished visual, not markup. CX Codex +1 ★ 276repo stars update-claudemd update-claudemd — a skill that checks CLAUDE.md and the topic files in .claude/rules/ against the actual code and commit history, then trims what went stale and regroups the instructions. CX Codex +1 ★ 276repo stars repair-skill repair-skill audits existing Claude Code skills against reference specs to spot frontmatter flaws, missing permissions, and syntax gaps. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open