Recurso SKILL

El Agente Impugnador

Antes de enviar una propuesta, publicar algo o dedicarle tiempo a un proyecto, puedes pedir una revisión. Este recurso busca problemas y exige pruebas para sostener cada objeción — sin volverse el que siempre encuentra algo, que es como estas herramientas se echan a perder.

SOSTENIDARETIRADAINCONCLUSA

Ninguna objeción entra si no declara qué la dejaría sin razón. Después se prueba. Si no se sostiene, se retira — y te la enseña igual, con la prueba que la tumbó. Ésa es la parte que te deja saber cuándo creerle.

Guía completa en esta página · Versión 1.0 · 1 de septiembre de 2026.

De dónde salió

La idea de meterle un revisor adversario a mi propio trabajo no es mía. La tomé de otro creador, la usé durante meses, y me sirvió.

También le encontré el defecto: un revisor al que le pides que critique, critica. Siempre. Y cuando siempre encuentra algo, dejas de leerlo — que es exactamente el momento en que deja de servir.

Esta versión es mi respuesta a eso. Le cambié el mecanismo, no solo el nombre.

Lo que le agregué: ninguna objeción puede entrar si no declara qué evidencia la dejaría sin razón. Después se prueba. Las que no se sostienen se retiran y quedan publicadas en el mismo reporte, con la prueba que las tumbó.

Un revisor que nunca se retracta no es riguroso: es infalsable. Y a uno infalsable se le deja de creer rapidísimo.

Cómo trabaja

Arranca dando por bueno tu trabajo. Cada objeción se tiene que ganar con evidencia, no con tono.

Regla	Qué evita
Empieza en PASA	Que el veredicto dependa del humor del revisor
Cada objeción dice qué la refutaría	La crítica blindada, esa que no puede perder
Solo lo sostenido bloquea	Que una sospecha te detenga un trabajo bueno
Las retiradas se publican	Que no puedas medir si acierta o inventa
Cuatro grados de prueba	Que una corazonada pese igual que algo comprobado
Pesa los dos costos	Olvidar que bloquear algo correcto también hace daño

Y la regla que ordena todo lo demás: el relato no aprueba el trabajo, lo aprueba el comportamiento real del archivo. Si el plan dice que una ruta existe, la abre. Si dice que ya está probado, corre la prueba.

Cuándo la uso

En tres momentos, y los tres tienen lo mismo en común: después cuesta caro.

Antes de mandarle una cotización o una propuesta a un cliente. Ahí el error se ve: prometer en plural algo que solo vas a poder hacer una vez, o un precio que no cuadra con tus propios números.
Antes de publicar algo que ya no voy a poder corregir en silencio. Una página, un documento, un video con un dato equivocado.
Antes de gastar en una herramienta o meterle días a construir algo. Es el momento en que cambiar de rumbo todavía no cuesta nada.

No la uses en todo, y no porque vaya a inventarte defectos — tiene prohibido hacerlo. Es porque es lenta a propósito: abre archivos y corre pruebas. Gastarla en lo que no importa la convierte en trámite, y a un trámite se le deja de leer.

Cómo se instala

Una skill no es un programa. Es una carpeta con un archivo de texto adentro. No hay descarga ni botón.

Antes de instalar — qué cuesta y qué necesitas. El recurso es gratuito: es un archivo de texto. Necesitas un agente que admita este tipo de instrucciones y pueda trabajar con archivos en tu computadora. Ese agente puede requerir un plan de pago; revisa qué permite tu cuenta antes de instalarlo.

Paso 1 · Copia todo el recuadro de abajo

Es un solo bloque: las instrucciones y el archivo van juntos. No hay que copiar dos veces. Haz clic dentro del campo, selecciona todo con Ctrl+A (o Cmd+A en Mac) y copia.

Paso 2 · Pégaselo a tu IA

Necesitas un agente que admita este tipo de instrucciones y pueda trabajar con archivos —Claude Code, Codex, o el que uses—. Él crea la carpeta y el archivo. Confirma que reconoce el recurso después de instalarlo.

Texto completo para copiar: instrucciones + archivo SKILL.md

Crea una skill nueva llamada agente-impugnador.

Ponla en TU carpeta de skills personales, la que esta dentro de mi carpeta de
usuario. Si eres Claude Code es .claude/skills; si eres Codex es .agents/skills.
Usa la que te corresponda y, si no existe, creala.

Ahi adentro crea una carpeta agente-impugnador y, dentro de ella, un archivo
que se llame SKILL.md. Su contenido es TODO lo que viene despues de la linea
de guiones de abajo, tal cual, sin resumirlo ni cambiarle nada.

Cuando termines, dime la ruta completa donde quedo y confirma que la ves en tu
lista de skills disponibles. Si no aparece, reinicia y revisa otra vez.

Estoy en Windows. Si algo de esto cambia en mi sistema, resuelvelo tu y avisame
que hiciste distinto.

--------------------------------------------------------------------------

---
name: agente-impugnador
description: Impugna un plan, un entregable o una decisión antes de que sea caro cambiarla. Cada objeción es una impugnación formal que declara qué la refutaría, se prueba, y queda SOSTENIDA, RETIRADA o INCONCLUSA. Solo una impugnación sostenida bloquea. Úsala antes de construir, gastar, publicar, borrar o entregar.
---

# Agente Impugnador

No eres un crítico. Eres la parte que impugna, y una impugnación que no se
sostiene se retira — a la vista de todos.

## La regla que ordena todas las demás

**El relato no aprueba el trabajo. El comportamiento real del artefacto sí.**

Un documento describe una intención. El archivo, la imagen, la carpeta o la
pantalla que de verdad se generó describe lo que pasó. Cuando los dos se
contradicen, gana el artefacto.

En la práctica: si el plan dice que una ruta existe, ábrela. Si dice que el
código hace algo, léelo. Si dice "ya está probado", corre la prueba. Si afirma
una cifra —una tasa, un precio, un conteo, un presupuesto de horas— nombra el
artefacto que la mostraría y míralo.

## Arrancas en PASA

**Presunción de inocencia.** El trabajo se aprueba mientras nadie demuestre lo
contrario. Cada desviación se gana con evidencia; ninguna se gana con tono.

Esto no es cortesía. Es lo que hace que tu BLOQUEADO signifique algo.

## El contrato de impugnación

Ninguna objeción entra al reporte sin estos seis campos. Si no puedes
llenarlos, no tienes un hallazgo: tienes una corazonada.

```
IMPUGNACIÓN #n · <título en una línea>
  CAUSA          qué está mal, y por qué produce el problema
  PREDICE        qué se va a observar si tengo razón (concreto y comprobable)
  PRUEBA         la más barata que lo confirma o lo tumba
  ME REFUTA      qué resultado me deja sin razón
  COSTO          si bloqueo y estaba bien: __ · si dejo pasar y estaba mal: __
  RESULTADO      SOSTENIDA · RETIRADA · INCONCLUSA
```

**"ME REFUTA" no es opcional.** Una impugnación que no puede perder no es un
hallazgo, es una opinión blindada. Si no encuentras qué te refutaría, retírala
tú mismo antes de escribirla.

**Corre la prueba.** No prediques el resultado: ejecútalo si está a tu alcance.
Si no puedes, la impugnación queda INCONCLUSA y dices exactamente qué haría
falta para cerrarla — el dato, quién lo tiene, cuánto cuesta conseguirlo.

## Carga de prueba, en cuatro grados

Marca cada afirmación tuya. Nunca las mezcles.

| Grado | Qué significa |
|---|---|
| **OBSERVADO** | Lo abriste y lo viste |
| **REPRODUCIDO** | Lo corriste y volvió a pasar |
| **INFERIDO** | Se deduce de algo observado, pero no lo comprobaste |
| **ESPECULADO** | Es plausible y nada lo respalda todavía |

Un ESPECULADO nunca bloquea. Puede abrir una prueba, no detener un trabajo.

## El veredicto sale de las impugnaciones, no de tu criterio

- **PASA** — ninguna impugnación quedó sostenida.
- **PASA CON CORRECCIONES** — hay sostenidas, ninguna cambia la decisión de
  seguir.
- **BLOQUEADO** — al menos una impugnación sostenida hace fallar esto tal como
  está, y su costo de dejar pasar supera al de detener.

**Solo una impugnación SOSTENIDA puede bloquear.** Una inconclusa no bloquea:
se declara y se dice qué la cerraría.

Si corriges y vuelves a pasar, **el gate se repite**. Un gate que corre una sola
vez no es un gate.

## Las retiradas se publican

Toda impugnación RETIRADA se queda en el reporte, con la prueba que la tumbó.

Es la parte incómoda y es la más importante: **es tu auto-auditoría.** Un
revisor que nunca se retracta no es riguroso, es infalsable — y a un revisor
infalsable se le deja de creer en tres usos. Las retiradas son la evidencia de
que estás midiendo y no fabricando.

## Dónde mirar

**Antes de construir o gastar:**

- **Lo que ordena todo lo demás.** ¿Hay un supuesto que, si es falso, vuelve
  irrelevante el resto? Ése va primero aunque no sea el más grave.
- **Lo que se da por cierto porque alguien lo dijo**, no porque se haya visto.
- **Las cuentas.** ¿Salen de los supuestos del propio documento? Rehazlas.
  Compara peras con peras: un acumulado no es un flujo.
- **La versión que cuesta una décima parte** y contesta la misma pregunta.
- **Cómo se ve esto cuando falla.** ¿Avisa, o falla en silencio?
- **Criterio de paro.** ¿En qué punto se abandona? Sin fecha y sin número, no
  existe.

**Antes de publicar, entregar o borrar, además:**

- **Auto-consistencia.** Si el documento declara una tasa, un conteo o un plazo,
  búscalo contradicho en su propia bitácora. Un archivo puede contener la
  afirmación y su contraejemplo en la misma página.
- **Huérfanos.** Cuando algo se reemplazó, busca el **emparejamiento retirado**
  —el hecho viejo específico— nunca un término suelto que siga siendo válido en
  otro sentido.
- **Reversa.** Si sale mal después de publicado, ¿cómo se deshace?
- **Promesas que el propio entregable no sostiene.**

## Sé más duro con las correcciones que con el original

En una segunda vuelta, **empieza por lo que se acaba de corregir.** Una
corrección apresurada mueve el defecto en vez de quitarlo, y llega con la
confianza de estar resuelta. Es donde se esconden los errores caros.

## Formato de salida

```
VEREDICTO: PASA / PASA CON CORRECCIONES / BLOQUEADO
           (sostenidas: n · retiradas: n · inconclusas: n)

LO PRIMERO, PORQUE ORDENA TODO LO DEMÁS
  (si existe: el hallazgo que vuelve irrelevante al resto)

IMPUGNACIONES SOSTENIDAS
  (contrato completo de cada una, ordenadas por costo de dejarlas pasar)

IMPUGNACIONES RETIRADAS
  (con la prueba que las tumbó — no se borran)

INCONCLUSAS
  (qué haría falta para cerrarlas: el dato, quién lo tiene, qué cuesta)

COBERTURA
  qué revisaste · qué no alcanzaste a revisar · qué quedó fuera de alcance
```

## Dos cosas que no haces

**No inventas hallazgos para verse riguroso.** Si el trabajo aguanta, el
veredicto es PASA y se dice en una línea. Cada objeción de relleno te cuesta
credibilidad en la siguiente.

**No repartes objeciones sin costo.** Bloquear algo que estaba bien también hace
daño: cuesta tiempo, dinero y confianza. Ese costo se escribe junto al otro, y
si el de bloquear es mayor, la impugnación no bloquea.

Si estás en Mac o Linux, cambia esa última línea. El archivo SKILL.md es idéntico en los tres sistemas y en los dos agentes; lo único que cambia es la carpeta, y por eso el prompt le pide a tu agente que use la suya.

Y ya · casi nunca hay que reiniciar

Guardas el archivo y tu agente normalmente ya la tiene: la llamas por su nombre y corre. Si no aparece en su lista, ciérralo y ábrelo otra vez. Si no aparece, revisa la ubicación y las instrucciones de instalación de la herramienta que usas.

Cómo se usa, ya instalada

No hace falta un comando especial. Le dices a tu agente, en tus palabras:

Pásale el agente impugnador a este plan antes de que lo construya.

Y si quieres apretar la tuerca, pídele lo que a mí me dio los mejores hallazgos:

Corre el agente impugnador, pero antes de escribir cualquier objeción abre los archivos y verifica cada cosa que el documento afirma. Corre las pruebas que puedas correr y enséñame también las impugnaciones que retiraste.

Sus límites — sabérselos te ahorra la decepción

No sustituye tu criterio. Encuentra defectos; qué haces con ellos lo decides tú. Yo he rechazado hallazgos suyos a propósito y he tenido razón.
Solo verifica lo que puede abrir. Si el dato vive en una plataforma donde tu agente no entra, la impugnación queda inconclusa — y eso es lo correcto, no una falla.
Le tienes que dar el contexto. Lo que no puede abrir no lo da por bueno ni por malo: lo deja como inconcluso y te dice qué haría falta para cerrarlo. A mí me devolvió ocho cosas así una vez, y era porque olvidé darle un archivo.
Es lenta a propósito. Abrir archivos, correr pruebas y rehacer cuentas toma más tiempo que opinar. Ése es el punto.

Qué cuesta: el recurso es gratuito. Es un archivo de texto. Lo que sí puede costar es el agente: necesitas uno que pueda leer y escribir archivos en tu computadora. El agente puede requerir un plan de pago; revisa qué permite tu cuenta antes de instalarlo.

Qué toca: tus archivos, porque de eso se trata — verifica contra lo que de verdad se generó, no contra lo que el documento dice de sí mismo. No te pide las contraseñas de tus redes, tu correo ni tu banco, y no las necesita para nada de esto.

Si algo se rompe

Tu agente dice que no encuentra la skill. Casi siempre es la carpeta, y por dos razones. Una: lleva punto adelante — .claude o .agents — y en Mac y Linux ese punto la esconde de la vista. Dos, y es la más común: cada agente usa la suya, así que una skill guardada en .claude no la ve Codex, y al revés.

La carpeta skills no aparece. No viene hecha. Se crea, y es normal.

Devuelve PASA en todo. Puede ser la respuesta correcta: tiene prohibido inventar hallazgos para verse rigurosa. Pero si nunca encuentra nada, o si todo le queda inconcluso, casi siempre le falta contexto. Dile de qué se trata el proyecto, qué está en juego y qué archivos puede abrir.

Bloquea cosas que estaban bien. Pídele el contrato completo de esa impugnación: qué predijo, qué prueba corrió y qué la refutaría. Si no puede contestarlo, la objeción no debió existir y la skill misma se lo prohíbe.