refactor-clean

Stars8

Forks2

UpdatedFebruary 16, 2026 at 10:39

Find and safely remove dead code, unused imports, and duplicate logic.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

bis-code

bis-code/claude-toolkit

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	refactor-clean
description	Find and safely remove dead code, unused imports, and duplicate logic.

/refactor-clean

Spawns the refactor-cleaner agent to identify unused code and safely remove it with test verification.

Steps

Gather context — determine the scope of cleanup:
- If arguments are provided (file paths or module names), scope to those
- Otherwise, scan the full src/ or project source directory
- Check for a working test suite (cleanup requires test verification)
Spawn the agent — use the Task tool:
```
Task tool with subagent_type="refactor-cleaner"
```
Pass in the prompt:
- The scope (specific files or full project)
- The test command from .claude-toolkit.json or auto-detected
- Any known entry points or public API files to protect
Present findings — relay the agent's cleanup report:
- List items removed (unused imports, dead functions, unreferenced files)
- List items flagged but not removed (uncertain usage)
- Suggested consolidations (duplicate logic that could be merged)
- Test results after cleanup
Offer follow-up actions:
- "Review flagged items?" — investigate uncertain items
- "Consolidate duplicates?" — merge suggested duplicate logic
- "Run full test suite?" — verify nothing was missed

More from this repository

same repository

agent-creator

bis-code/claude-toolkit

Interactive agent builder: guides the user through defining a new agent as a behavioral spec, then generates the agent .md and installs it.

2026-05-298

deep-dive

bis-code/claude-toolkit

Cross-repo investigation: research planning issues, break down into sub-issues, generate ralph session prompts per repo.

2026-05-298

bis-code/claude-toolkit

Three-phase QA orchestrator: parallel scan, interactive triage, guided fix.

2026-05-298

ralph

bis-code/claude-toolkit

Interactive feature builder with subagent delegation and approval gates.

2026-05-298

rule-creator

bis-code/claude-toolkit

Interactive rule builder: guides the user through defining a new rule as a constraint doc, then generates the rule .md and installs it.

2026-05-298

skill-creator

bis-code/claude-toolkit

Interactive skill builder: guides the user through defining a new skill as a structured SOP, then generates the SKILL.md and installs it.

2026-05-298

name	refactor-clean
description	Find and safely remove dead code, unused imports, and duplicate logic.

/refactor-clean

Spawns the refactor-cleaner agent to identify unused code and safely remove it with test verification.

Steps

Gather context — determine the scope of cleanup:
- If arguments are provided (file paths or module names), scope to those
- Otherwise, scan the full src/ or project source directory
- Check for a working test suite (cleanup requires test verification)
Spawn the agent — use the Task tool:
```
Task tool with subagent_type="refactor-cleaner"
```
Pass in the prompt:
- The scope (specific files or full project)
- The test command from .claude-toolkit.json or auto-detected
- Any known entry points or public API files to protect
Present findings — relay the agent's cleanup report:
- List items removed (unused imports, dead functions, unreferenced files)
- List items flagged but not removed (uncertain usage)
- Suggested consolidations (duplicate logic that could be merged)
- Test results after cleanup
Offer follow-up actions:
- "Review flagged items?" — investigate uncertain items
- "Consolidate duplicates?" — merge suggested duplicate logic
- "Run full test suite?" — verify nothing was missed