# Codebase Refactoring (agent skill)

> Codebase Refactoring is an agent skill (a SKILL.md file) from kucherenko/jscpd. Three-part workflow to improve overall codebase health with jscpd — find and fix duplicated code, find and remove or refactor dead code, then find and simplify the largest/most complex files. It works with Claude Code and has 6,346 GitHub stars across a repository of 3 listed skills.

Three-part workflow to improve overall codebase health with jscpd — find and fix duplicated code, find and remove or refactor dead code, then find and simplify the largest/most complex files. Starts from --dashboard/--health to prioritize and ends by re-measuring the score. A guided pass over a codebase's three biggest maintenance costs — duplicated code, dead code, and complexity — using jscpd to find each and a strategy to fix it.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/kucherenko/jscpd |
| Skill path | skills/codebase-refactoring/SKILL.md |
| Skill name | codebase-refactoring |
| GitHub stars | 6,346 |
| Installs on skills.sh | not listed |
| License | MIT |
| Skills in repo | 3 |
| Plugin marketplace | no |
| Official | no |
| Works with | Claude Code |
| Category | Coding |
| Last commit | Oct 7, 2026 |

## Add this skill

### Claude Code

```sh
git clone --depth 1 https://github.com/kucherenko/jscpd.git
cp -r jscpd/skills/codebase-refactoring ~/.claude/skills/codebase-refactoring   # personal, or .claude/skills in a project
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/kucherenko/jscpd.git
cp -r jscpd/skills/codebase-refactoring .agents/skills/codebase-refactoring   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/kucherenko/jscpd.git
cp -r jscpd/skills/codebase-refactoring .cursor/skills/codebase-refactoring   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/kucherenko-codebase-refactoring
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.