a5c-ai/babysitter / library/specializations/code-migration-modernization/skills/refactoring-assistant
refactoring-assistant
VerifiedSuggest and guide application of refactoring patterns to improve code quality
SKILL.md
View on GitHub---
name: refactoring-assistant
description: Suggest and guide application of refactoring patterns to improve code quality
allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Edit"]
graph:
domains: [domain:software-engineering]
specializations: [specialization:code-migration-modernization]
skillAreas: [skill-area:dead-code-elimination, skill-area:code-analysis-linting]
roles: [role:backend-engineer, role:refactor-bot]
workflows: [workflow:technical-debt-reduction]
topics: [topic:refactoring]
---
# Refactoring Assistant Skill
Suggests appropriate refactoring patterns and guides their application to improve code quality, maintainability, and migration readiness.
## Purpose
Enable guided refactoring for:
- Code quality improvement
- Design pattern application
- Migration preparation
- Technical debt reduction
- Maintainability enhancement
## Capabilities
### 1. Extract Method/Class Suggestions
- Identify extraction candidates
- Suggest method boundaries
- Recommend class decomposition
- Guide interface extraction
### 2. Move Method Recommendations
- Detect misplaced methods
- Suggest target classes
- Analyze dependencies
- Guide safe relocation
### 3. Rename Refactoring
- Suggest meaningful names
- Propagate renames safely
- Handle cross-references
- Update documentation
### 4. Inline Refactoring
- Identify inline candidates
- Remove unnecessary indirection
- Simplify call chains
- Reduce complexity
### 5. Pull Up/Push Down Member
- Analyze inheritance hierarchies
- Suggest member movement
- Optimize class hierarchies
- Improve polymorphism
### 6. Design Pattern Application
- Recognize pattern opportunities
- Guide pattern implementation
- Suggest appropriate patterns
- Validate pattern application
## Tool Integrations
| Tool | Purpose | Integration Method |
|------|---------|-------------------|
| IDE Refactoring | Automated refactoring | CLI / API |
| Sourcery | AI-powered suggestions | CLI |
| Sourcegraph Cody | Code intelligence | API |
| IntelliJ IDEA | Java refactoring | CLI |
| VS Code | Multi-language | Extension API |
## Output Schema
```json
{
"analysisId": "string",
"timestamp": "ISO8601",
"suggestions": [
{
"type": "extract-method|move-method|rename|inline|design-pattern",
"priority": "high|medium|low",
"target": {
"file": "string",
"element": "string",
"line": "number"
},
"description": "string",
"rationale": "string",
"steps": ["string"],
"estimatedImpact": {
"complexity": "string",
"maintainability": "string",
"testability": "string"
},
"risks": ["string"]
}
],
"patterns": {
"applicable": ["string"],
"opportunities": []
}
}
```
## Integration with Migration Processes
- **code-refactoring**: Primary refactoring guidance
- **technical-debt-remediation**: Debt reduction strategies
## Related Skills
- `code-smell-detector`: Identifies refactoring needs
- `codemod-executor`: Automates refactorings
## Related Agents
- `code-transformation-executor`: Executes suggested refactorings
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |