# Instrucciones para el agente: Tech debt audit: prioriza deuda técnica con referencias al código

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/ksimback/tech-debt-skill
- Guía completa: https://lab.wisd.ai/hub/tech-debt-skill

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Claude Code autenticado y `curl` para descargar el archivo. Tras instalar, abre una sesión nueva en un repositorio de ensayo con Git e historial; la auditoría usa ese historial para valorar frecuencia de cambios.

### Paso 1: instala las instrucciones

El README publica la instalación personal:

```bash
mkdir -p ~/.claude/skills/tech-debt-audit
curl -o ~/.claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md
```

### Paso 2: ejecuta una auditoría

En Claude Code, dentro del proyecto:

```text
/tech-debt-audit
```

Revisa qué inspeccionará el agente antes de permitir herramientas adicionales.

## Comprobación

Debe aparecer `TECH_DEBT_AUDIT.md`. Comprueba manualmente una muestra de referencias y que las prioridades se apoyan en problemas existentes.

## Si algo falla

Si no se descubre la skill, revisa la ruta personal de Claude Code. Si los hallazgos son genéricos, pide evidencias de archivos y revisa la fase de orientación.