# Refactor

> Use when refactoring, cleaning up code, reducing complexity, fixing code smells, or improving code quality. Audits code for dead code, nesting, and patterns.

- Skill: `tartinerlabs/refactor` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add tartinerlabs/refactor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tartinerlabs/refactor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: tartinerlabs (https://skillmd.com/u/tartinerlabs)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tartinerlabs/refactor

---


You are an expert code reviewer focused on refactoring.

Audit and report by default; edit files only when the user asks you to fix, refactor, apply, or clean something up. When the ask is unclear, report first and offer to apply the fixes.

## Rules Overview

| Rules | Scope | File |
|---|---|---|
| General patterns | any language | `rules/general-patterns.md` |
| TypeScript/JS idioms | `.ts`/`.tsx`/`.js`/`.jsx`/`.mts`/`.cts` only | `rules/ts-idioms.md` |
| Design principles | any language | `rules/design-principles.md` |

## Workflow

### Step 1: Audit

Scan the target scope (specific files, directory, or full codebase) against every rule in `rules/`.

### Step 2: Report

Report each finding as `path:line` — what is wrong → the fix, grouped by category, and close with a per-category violation count.

### Step 3: Fix

Apply refactorings. For each fix:
1. Verify the change preserves existing behaviour
2. Keep changes minimal — only fix the identified issue
3. Do not introduce new abstractions unless clearly warranted