Skip to content
refactoring

Refactor Extract

Extract a selected code block into a reusable function, with proper typing and tests.

/refactor-extract

Install this skill

  1. 1. Copy the SKILL.md content (button above)
  2. 2. Create a folder for the skill:
    # Mac/Linux
    mkdir -p ~/.claude/skills/refactor-extract
    
    # Windows (PowerShell)
    mkdir $env:USERPROFILE\.claude\skills\refactor-extract
  3. 3. Save the content as ~/.claude/skills/refactor-extract/SKILL.md
  4. 4. Restart Claude Code (or open a new session)
  5. 5. Type /refactor-extract to invoke it
clean-codeextractiondry

/refactor-extract

Convierte un bloque inline en una función reutilizable.

Usage

/refactor-extract <file>:<startLine>-<endLine> /refactor-extract <selection> --name validateUser

Pasos

1. Analizar el bloque

  • Qué variables externas usa
  • Qué retorna implícitamente
  • Side effects que tiene

2. Diseñar la signature

  • Inputs: cada variable externa = parámetro
  • Output: lo que se asigna o retorna después
  • Types apropiados (TS/Python type hints)

3. Decidir ubicación

  • Si solo se usa en este archivo: top del archivo o sección // helpers
  • Si reusable: extrae a lib/ o utils/

4. Reemplazar

  • Inserta la nueva función
  • Reemplaza el código original con la llamada
  • Actualiza imports

5. Generar test

Casos: feliz, vacío, error.

Reglas

  • No cambiar comportamiento observable
  • Conservar nombres de variables que sean del dominio
  • Si la extracción no mejora claridad, NO HACER
Refactor Extract | MCPFlix