Skip to content
Back to skills

Refactor Surgeon

ASecurity

Refactoriza con red: mide complejidad y anidamiento, graba casos dorados, propone cortes por grafo de llamadas y verifican que la conducta no cambió.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgogit

Security analysis

A100/100

Pro scans all 20 files and shows the line behind each finding

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill refactor-surgeon --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Refactor Surgeon?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Refactor Surgeon
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-refactor-surgeon/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-refactor-surgeon)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: refactor-surgeon
description: Refactoriza con red: mide complejidad y anidamiento, graba casos dorados, propone cortes por grafo de llamadas y verifican que la conducta no cambió.
license: MIT
metadata:
  package: refactor-surgeon
  version: "1.4.0"
---

# Refactor Surgeon

## Propósito

Cambiar la forma del código sin cambiar lo que hace: primero medir, luego congelar la conducta con casos dorados, después cortar y al final verificar que nada se movió.

## Flujo

1. **Medir** con `refactor-metrics`: complejidad ciclomática, anidamiento y nota de mantenibilidad por función.
2. **Priorizar** con `refactor-hotspots`: churn × complejidad desde un `--since` explícito.
3. **Congelar** con `refactor-harness`: graba los casos dorados antes de tocar nada.
4. **Purgar** con `refactor-deadcode`: imports y definiciones privadas que ya nadie usa.
5. **Deduplicar** con `refactor-clones`: los bloques que solo cambian de nombre se unifican antes de cortar.
6. **Desenredar** con `refactor-cycles`: los módulos que se importan en círculo no se cortan todavía.
7. **Cortar** con `refactor-slice`: el grafo de llamadas dice qué funciones forman un módulo.
8. **Verificar** con `refactor-verify`: los mismos casos deben dar el mismo resultado.

## Sub-skills

| Sub-skill | Qué hace |
|---|---|
| `refactor-metrics` | Complejidad, anidamiento y mantenibilidad por función |
| `refactor-hotspots` | Churn × complejidad desde git log, con degradación explícita |
| `refactor-harness` | Graba casos dorados antes del cambio |
| `refactor-deadcode` | Imports y definiciones privadas sin uso |
| `refactor-clones` | Duplicación por shingles normalizados del AST |
| `refactor-cycles` | Ciclos de imports entre módulos |
| `refactor-slice` | Componentes conexas del grafo de llamadas |
| `refactor-verify` | Compara la conducta contra los casos grabados |

## Reglas

- Sin casos dorados no se refactoriza: primero se congela la conducta.
- Un refactor no cambia comportamiento; si cambia algo, se convierte en otro cambio.
- Cada corte se justifica con métricas de antes y después, no con impresiones.
- Lo que se borra por muerto se confirma contra los casos dorados, no por intuición.

## Gate de salida

- Métricas antes y después, y la nota de mantenibilidad.
- Casos dorados grabados y verificados sin discrepancias.
- Los cortes aplicados quedan listados con su grupo de funciones.

## Handoff

Entrega a `refactor-verify` el snapshot y el comando de verificación. Si aparece una discrepancia, el cambio se revierte antes de seguir cortando.

Files in this skill

  • SKILL.md2.5 KB
  • refactor-clones/SKILL.md2.4 KB
  • refactor-cycles/SKILL.md2.2 KB
  • refactor-deadcode/SKILL.md2.2 KB
  • refactor-harness/SKILL.md1.9 KB
  • refactor-hotspots/SKILL.md2.6 KB
  • refactor-metrics/SKILL.md1.5 KB
  • refactor-slice/SKILL.md1.7 KB
  • refactor-verify/SKILL.md1.6 KB
  • scripts/clone_detect.py5.9 KB
  • scripts/code_metrics.py4.8 KB
  • scripts/dead_code.py7.3 KB
  • scripts/golden_harness.py4.5 KB
  • scripts/hotspots.py5.5 KB
  • scripts/import_cycles.py6.6 KB
  • scripts/slice_analyzer.py3.2 KB
  • skills.json1.7 KB
  • tests/test_clone_detect.py4.9 KB
  • tests/test_code_metrics.py2.8 KB
  • tests/test_dead_code.py4.4 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.