El patrón lo zanja
Rayas, punto y coma, comillas curvas, vocabulario vetado, la negación que antepone lo que algo no es, y los conectores de IA. Pasarse hace fallar el build.
Open Source · JavaScript
human
Cuenta los tics de IA en un borrador y sale con error si alguno pasa su umbral. Toma un patrón, lo busca en cada párrafo, encabezado y cita del documento, e imprime el número. 32 detectores y 4 medidas de ritmo, en español y en inglés.
$
npm install -g @e1i0/human
Un modelo no encuentra sus propios tics
Las otras herramientas le piden a un modelo que lea un borrador y lo califique. Ese modelo no encuentra nada, porque la prosa está justo donde él la habría puesto.
Lo comprobé construyendo esto. En una sola pasada de arreglos sobre esta página, el contador encontró seis tics nuevos que yo había escrito mientras quitaba los viejos. Ninguno me pareció sospechoso al releerlo.
$ human borrador.md
borrador.md 3 unidades · 6 frases · 41 palabras
HARD
! vocabulario vetado 2
L3 No es una herramienta más, es una plataforma, robusta y comprehensiva.
L3 Es importante notar que esto resulta crucial para el equipo.
! no es X, es Y 1
L3 No es una herramienta más, es una plataforma, robusta y comprehensiva.
REVIEW
? lo que X es Y 1
L1 Lo que hace este sistema es coordinar procesos y además, lo hace bien.
? arranque repetido 2
L5 Nadie mira. || Nadie mide.
L5 Nadie mide. || Nadie lo nota.
RITMO
! rango largo-corto 11 >= 20 FALLA
! banda 10-20 50 <= 49 FALLA
4 sobre el umbral
Ese es el modo corto. El completo imprime los treinta y dos con su cuenta, ceros incluidos, porque si solo te dice "se ve limpio" no tienes cómo saber si revisó: un detector roto se ve idéntico a uno que no encontró nada.
El código de salida es la cantidad de umbrales excedidos, así que entra en un hook de pre-commit o en CI sin tocar nada.
Tres niveles, y separarlos es lo que hace que sirva
Mezclados, los hallazgos reales quedan debajo de una pila de falsos positivos, y entonces abres el reporte una vez y no lo vuelves a abrir.
Lo decides tú
El patrón señala y no puede decidir, así que cada uno trae al lado la versión legítima con la que se confunde.
La forma de las frases
Rango entre la más larga y la más corta, cuántas caen entre 10 y 20 palabras, si existe una corta, y tres seguidas del mismo tamaño.
Cuatro de los veintiséis son sólo para español: vocabulario peninsular en un texto para Latinoamérica, modismos ingleses traducidos palabra por palabra, el posesivo que convierte en cosa un sí o un no ("esperando tu sí"), y la palabra de tesis donde ibas a escribir la llana (enunciar por decir).
Las cuentas llegan sin que nadie las pida
Una skill no obliga a nadie a seguirla, y un hook no necesita que nadie se acuerde. Son tres entradas en ~/.claude/settings.json, y un comando las quita.
Escribir
Te entrega el registro que declaró el proyecto. Si lo lees después de escribir el borrador ya es tarde.
Write, Edit
Cuenta ese archivo. Si no hay nada que mirar no dice nada: si te avisara en cada edición lo desinstalas a la semana.
Bash
Le pregunta a git qué archivos de prosa tocaste. Un heredoc que reescribe una página entra como llamada a Bash, y el hook de Write no la ve.
Los umbrales salen de prosa que ya te gusta
Cada número acá es un juicio que alguien hizo una vez. human-calibrate mide prosa que tú ya apruebas y reemplaza esos números. Lo probé con 34.250 palabras de un autor, 29 piezas: las reglas duras no dispararon ni una vez. La medida de tríos sí, y estaba mal puesta. El umbral era cero y la mediana de ese autor es tres, o sea que le marcaba su ritmo normal como error.
El corpus tiene que ser prosa que esta herramienta nunca tocó, y eso deja fuera casi todo lo que tienes. Tu historial de chat no pasa por un modelo, así que human-voice lee tus propios mensajes y escribe el perfil. Ese archivo se queda en tu máquina. No hay nada que publicar: quien lo corra contra su historial saca el suyo.
Lo que un patrón no puede hacer
Cinco de los seis duros tienen arreglo automático. El sexto es la negación que antepone lo que algo no es, y para esa no hay función posible. Cambiarla exige decir qué es la cosa, y eso no lo sabe un regex.
Tampoco lee, así que nunca agarra un número que contradice a otro número ni un término usado noventa líneas antes de explicarse. Una versión anterior de esta página salió limpia de los 32 detectores. Le pedí a alguien que no la había escrito que la leyera, y encontró treinta cosas: una cuenta que no cuadraba, una misma forma de frase repetida seis veces, y tres modismos ingleses traducidos palabra por palabra en una página que vende encontrar eso. Ese lector no puede ser quien escribió el borrador, y la skill trae el prompt para lanzarlo.
Pruébalo sin instalar nada
Te subraya cada hallazgo en el texto. En los cinco que tienen arreglo automático te muestra el cambio antes de aplicarlo, con un botón que dice qué va a hacer. Ningún servidor recibe el texto, que es la única forma honesta de ofrecerlo cuando lo que estás pegando todavía no lo has publicado.
Necesita Node 20 o más nuevo, y no arrastra dependencias
MIT. El catálogo de patrones viene de harshaneel/humanize. Lo que puse yo: los patrones en español, el orden en que se revisan, y contar en vez de pedirle opinión a un modelo.