# Refactor Suggestions

> Inspect the repository for code changes and recommend refactors.

- Skill: `majiayu000/refactor-suggestions-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/refactor-suggestions-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/refactor-suggestions-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/majiayu000/refactor-suggestions-2

---


---
name: refactor-suggestions
description: Suggest refactors for modified code focusing on security, maintainability, readability,
and functional programming purity.
Use when: (1) reviewing changed functions for cleanup opportunities,
(2) preparing scoped refactor follow-up work,
(3) identifying non-blocking improvement candidates after implementation.

category: principles
disable-model-invocation: false
user-invocable: true
allowed-tools: Read, Grep, Glob, Bash
---

# 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