# Refactor Suggestions

> Suggest refactors for modified code focusing on security, maintainability, readability, and functional programming purity

- Skill: `majiayu000/refactor-suggestions` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/refactor-suggestions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/refactor-suggestions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/refactor-suggestions

---


# Refactor Suggestions

Inspect the repository for code changes and recommend refactors.

## Procedure

### Phase 1 - Get the Changes
1. Get all changes in this branch compared to the default branch since it diverged
2. Scoped from those changes, analyze code from modified and added functions
3. Suggest (do not re-write functions) refactors focused on:
   - Security
   - Maintainability
   - Readability
   - Logic flow
   - Functional programming purity

### Refactor Categories to Consider
- Increases purity and immutability
- Reduces side effects and shared state
- Improves readability and testability
- Eliminates security anti-patterns
- Simplifies complex conditionals
- Extracts reusable utilities
- Improves error handling

### Phase 2 - Return Suggestions

Return Markdown structured as follows:

```markdown
# Suggestions

**functionName**
location: src/path/to/file.ts `functionName`
description: Detailed explanation of why this function should be refactored
refactor strategy: Explain rationale explicitly
refactored code:
```
function() {
  // suggested implementation
}
```

**anotherFunction**
...
```

## Constraints
- Analyze only within the given code. Do not invent missing context or external APIs
- Be deterministic and concise
- Focus on actionable, specific suggestions