repair-skill — Claude Code skill: what it does, how to install
repair-skill audits existing Claude Code skills against reference specs to spot frontmatter flaws, missing permissions, and syntax gaps.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-skills@ClaudestWhat repair-skill 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.
What it helps with
- audit existing
SKILL.mdfiles 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 for the agent
- Audit this skill at ./plugins/claude-skills/skills/git-helper
- Fix my skill in ~/.claude/skills/extract-data
- Run diagnostics on ./SKILL.md
How to install repair-skill
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-skill -a claude-code3Manually: put the files in place
~/.claude/skills/repair-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/repair-skill/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-skill -a codex2Manually: put the files in place
.agents/skills/repair-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-skill -a cursor2Manually: put the files in place
.cursor/skills/repair-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-skills/skills/repair-skill2Manually: put the files in place
.github/skills/repair-skill/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill repair-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-skills/skills/repair-skillManually: put the files in place
.devin/skills/repair-skill/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-skill
How to install repair-skill in Claude Code?
Run both marketplace commands in order: /plugin marketplace add gupsammy/Claudest followed by /plugin install claude-skills@Claudest.
What does repair-skill do?
It parses an existing skill definition, identifies formatting or permission violations, and outputs an itemized remediation plan.
Can repair-skill audit sub-agents?
No, sub-agents require repair-agent, while adding new capabilities to an existing skill is handled by improve-skill.