code-refactor — скилл для Claude Code: переименование и замена кода
Скилл code-refactor для Claude Code массово переименовывает переменные и функции, заменяет устаревшие паттерны и обновляет вызовы API в нескольких файлах. Для 10+ файлов автоматически выбирает режим, экономящий до 90% токенов.
Apache-2.0 304 установок ★ 697 обновлён 2026-07-25
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-codeЧто делает code-refactor
code-refactor помогает рефакторить код структурированно. Сначала находит все вхождения паттерна (переменная, функция, строка кода), показывает контекст каждого совпадения, потом применяет замену одновременно во всех найденных местах.
Для 1–9 файлов скилл использует встроенные инструменты: поиск по grep и правку с флагом replace_all=true. Если файлов 10 и больше, автоматически переключается на режим выполнения с Python-скриптом — это даёт 90% экономию токенов на больших кодовых базах. Например, переименование в 50 файлах требует примерно 500 токенов вместо 25 000.
Скилл учитывает граничные случаи: спрашивает, обновлять ли совпадения внутри строк и комментариев, предупреждает о breaking changes в публичных API. Рекомендует запустить тесты после каждого изменения.
Какие задачи решает
- переименовать переменную или функцию во всём проекте
- заменить устаревший паттерн (например,
varнаlet) - обновить все вызовы к API (сменить версию эндпоинта)
- унифицировать код по новому стилю или библиотеке
- найти и удалить дублированный код в нескольких местах
Примеры запросов агенту
- Переименуй
getUserDataнаfetchUserDataво всех файлах - Замени все
/api/auth/loginна/api/v2/authentication/login - Обнови все
varнаletв папкеsrc/, но только при условии переприсваивания
Как установить code-refactor
1Через Skills CLI (Vercel)
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-code2Вручную: положить файлы
~/.claude/skills/code-refactor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/code-refactor/
1Через Skills CLI (Vercel)
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a codex2Вручную: положить файлы
.agents/skills/code-refactor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a cursor2Вручную: положить файлы
.cursor/skills/code-refactor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mhattingpete/claude-skills-marketplace code-operations-plugin/skills/code-refactor2Вручную: положить файлы
.github/skills/code-refactor/SKILL.md1Через Skills CLI (Vercel)
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a gemini-cli2Командой платформы
gemini skills install https://github.com/mhattingpete/claude-skills-marketplace --path code-operations-plugin/skills/code-refactorВручную: положить файлы
.devin/skills/code-refactor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о code-refactor
Как установить code-refactor в Claude Code?
Выполни npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-code, потом проверь файл ~/.claude/skills/code-refactor/SKILL.md.
Что делает code-refactor?
Находит все вхождения кода (переменная, функция, паттерн) по всему проекту, показывает контекст каждого совпадения и применяет замену одновременно во всех найденных файлах. Для больших кодовых баз (10+ файлов) автоматически использует Python-скрипт и экономит токены.
В чём разница между режимом для 1–9 файлов и 10+ файлов?
До 9 файлов скилл работает встроенными инструментами (grep + edit). Начиная с 10 файлов, переключается на code-execution с Python-скриптом rename_identifier — экономит 90% токенов, особенно полезно для больших проектов.
Исходный текст
SKILL.md · Apache-2.0
---
name: code-refactor
description: Perform bulk code refactoring operations like renaming variables/functions across files, replacing patterns, and updating API calls. Use when users request renaming identifiers, replacing deprecated code patterns, updating method calls, or making consistent changes across multiple locations.
---
# Code Refactor
Systematic code refactoring across files. **Auto-switches to execution mode** for 10+ files (90% token savings).
## Mode Selection
- **1-9 files**: Use native tools (Grep + Edit with replace_all)
- **10+ files**: Automatically use `code-execution` skill
**Execution example (50 files):**
```python
from api.code_transform import rename_identifier
result = rename_identifier('.', 'oldName', 'newName', '**/*.py')
# Returns: {'files_modified': 50, 'total_replacements': 247}
# ~500 tokens vs ~25,000 tokens traditional
```
## When to Use
- "rename [identifier] to [new_name]"
- "replace all [pattern] with [replacement]"
- "refactor to use [new_pattern]"
- "update all calls to [function/API]"
- "convert [old_pattern] to [new_pattern]"
## Core Workflow (Native Mode)
### 1. Find All Occurrences
```
Grep(pattern="getUserData", output_mode="files_with_matches") # Find files
Grep(pattern="getUserData", output_mode="content", -n=true, -B=2, -A=2) # Verify with context
```
### 2. Replace All Instances
```
Edit(
file_path="src/api.js",
old_string="getUserData",
new_string="fetchUserData",
replace_all=true
)
```
### 3. Verify Changes
```
Grep(pattern="getUserData", output_mode="files_with_matches") # Should return none
```
## Workflow Examples
### Rename Function
1. Find: `Grep(pattern="getUserData", output_mode="files_with_matches")`
2. Count: "Found 15 occurrences in 5 files"
3. Replace in each file with `replace_all=true`
4. Verify: Re-run Grep
5. Suggest: Run tests
### Replace Deprecated Pattern
1. Find: `Grep(pattern="\\bvar\\s+\\w+", output_mode="content", -n=true)`
2. Analyze: Check if reassigned (let) or constant (const)
3. Replace: `Edit(old_string="var count = 0", new_string="let count = 0")`
4. Verify: `npm run lint`
### Update API Calls
1. Find: `Grep(pattern="/api/auth/login", output_mode="content", -n=true)`
2. Replace: `Edit(old_string="'/api/auth/login'", new_string="'/api/v2/authentication/login'", replace_all=true)`
3. Test: Recommend integration tests
## Best Practices
**Planning:**
- Find all instances first
- Review context of each match
- Inform user of scope
- Consider edge cases (strings, comments)
**Safe Process:**
1. Search → Find all
2. Analyze → Verify appropriate
3. Inform → Tell user scope
4. Execute → Make changes
5. Verify → Confirm applied
6. Test → Suggest running tests
**Edge Cases:**
- Strings/comments: Ask if should update
- Exported APIs: Warn of breaking changes
- Case sensitivity: Be explicit
## Tool Reference
**Edit with replace_all:**
- `replace_all=true`: Replace all occurrences
- `replace_all=false`: Replace only first (or fail if multiple)
- Must match EXACTLY (whitespace, quotes)
**Grep patterns:**
- `-n=true`: Show line numbers
- `-B=N, -A=N`: Context lines
- `-i=true`: Case-insensitive
- `type="py"`: Filter by file type
## Integration
- **test-fixing**: Fix broken tests after refactoring
- **code-transfer**: Move refactored code
- **feature-planning**: Plan large refactorings
© mhattingpete · Apache-2.0 · mhattingpete/claude-skills-marketplace