Humanizer — la skill que saca el tono de IA de cualquier texto (Claude Code y OpenCode)
Guía para instalar y usar Humanizer, la skill open source de blader que detecta y elimina los 29 patrones más típicos de escritura por IA: em dashes, listas en threes, hedging, vocabulario inflado, voz pasiva y más. Para Claude Code y OpenCode.
Si estás construyendo agentes de IA con Claude Code para atención al cliente, ventas o cualquier producto donde un humano del otro lado va a leer lo que escribe el agente, hay un problema casi universal: cualquiera que reciba esos mensajes se da cuenta a los pocos segundos que del otro lado hay una IA, no una persona. Y eso quema ventas, conversaciones y confianza.
Humanizer es una skill open source de blader que reescribe texto para sacar las marcas más obvias de escritura por LLM. Funciona como skill nativa en Claude Code y OpenCode — la invocás con /humanizer y le pegás el texto.
- 📦 Repo: github.com/blader/humanizer
- 📄 Licencia: MIT
- ⭐ 18k+ stars
Qué problema resuelve
Los LLMs (Claude, GPT, Gemini) están entrenados con una distribución estadística masiva de texto en internet. Cuando generan, tienden al resultado más probable que sirva para la mayor variedad de casos — y eso produce un dialecto reconocible: estructuras tipo "It's not just X, it's Y", tríadas de tres elementos, em dashes por todos lados, abuso de negritas, frases como "let's dive in" o "at its core", listas con inline-header: y conclusiones genéricas tipo "the future looks bright".
Humanizer detecta 29 patrones específicos en 3 categorías y los reescribe.
| Categoría | Ejemplos de patrones detectados |
|---|---|
| Lenguaje | Vocabulario AI (testament, landscape, showcasing), evitar copulas (serves as → is), tailing negations (..., no guessing), regla de tres (innovation, inspiration, insights), synonym cycling, falsos rangos, voz pasiva |
| Estilo | Em dash overuse, negritas decorativas, listas inline-header, Title Case en headings, emojis, comillas curly, pares hifenizados, "at its core...", "let's dive in", headers fragmentados |
| Filler / hedging | "in order to" → "to", "could potentially possibly" → "may", conclusiones genéricas |
La lista completa con before/after está en el README del repo.
Instalación
La skill es un archivo SKILL.md que cloneás dentro del directorio de skills de tu cliente.
Claude Code
mkdir -p ~/.claude/skills
git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
Reiniciá Claude Code para que la skill quede registrada.
OpenCode
mkdir -p ~/.config/opencode/skills
git clone https://github.com/blader/humanizer.git ~/.config/opencode/skills/humanizer
OpenCode también escanea ~/.claude/skills/ para compatibilidad. Si ya instalaste para Claude Code, no hace falta clonar de nuevo — la skill queda disponible en ambos.
Si ya tenés el repo clonado en otro lado
Podés copiar solo el archivo de skill:
mkdir -p ~/.claude/skills/humanizer
cp SKILL.md ~/.claude/skills/humanizer/
Cómo usarla
Modo directo — slash command
Dentro de Claude Code (o OpenCode):
/humanizer
[pegás el texto que querés humanizar]
La skill lo procesa contra los 29 patrones y te devuelve la versión reescrita.
Modo conversacional
También funciona pidiéndoselo en lenguaje natural:
"Por favor humanizá este texto: [...el texto...]"
Claude carga la skill automáticamente y aplica las mismas reglas.
Casos de uso reales
1. Agentes de IA para atención al cliente / ventas
El caso que justifica el costo de instalarla. Cuando armás un agente que responde por WhatsApp, Instagram, email o chat web, wrappear cada respuesta del agente con un paso de humanización antes de enviársela al cliente cambia totalmente la percepción.
Workflow recomendado en el system prompt del agente:
Antes de devolver la respuesta final al usuario:
1. Generá la respuesta normalmente
2. Aplicá la skill humanizer sobre ella
3. Devolvé la versión humanizada
Nunca uses em dashes, listas con bold-headers, ni frases tipo
"let's dive in" o "at its core". Tono: conversacional, español
rioplatense, frases cortas.
2. Limpiar contenido antes de publicarlo
Posts de LinkedIn, threads de X, captions de Instagram, descripciones de producto. Todo texto que generaste con un LLM y querés que no huela a IA antes de publicar.
/humanizer
[pegás el draft del post]
3. Emails fríos (cold email)
Los cold emails generados por IA tienen una tasa de respuesta brutalmente baja porque se detectan al instante. Pasar cada variación por humanizer mejora deliverability percibida y respuestas.
4. Documentación técnica
Si usás Claude Code para generar docs y querés que el README no parezca generado por un bot — /humanizer saca los emojis decorativos, las listas tipo "🚀 Launch Phase:", las negritas innecesarias y los "let's dive in".
Combos que potencian la skill
- + Mejorá tu prompt base: humanizer es post-procesamiento, no reemplaza un buen prompt. Si tu prompt ya pide "tono conversacional, frases cortas, evitar em dashes y listas", el output sale más limpio de entrada y humanizer hace menos trabajo. Para esto te sirve la guía de errores comunes en Claude Code.
- + Superpowers: si usás Superpowers, agregá humanizer al final del workflow de cualquier skill que genere texto orientado al usuario.
- + Claude-Mem: con Claude-Mem instalado, las observaciones de las sesiones quedan guardadas — así Claude aprende qué patrones de texto preferís para tu negocio específico.
Limitaciones honestas
- No es mágica. Es reescritura basada en reglas + criterio del modelo. Texto muy malo de origen sigue siendo texto malo, solo que sin em dashes.
- Funciona mejor en inglés que en español — los 29 patrones están descritos con ejemplos en inglés. En español rioplatense la skill igual ayuda (saca los anglicismos, las negritas decorativas, los emojis), pero puede dejar pasar algunos patrones específicos del español-IA.
- Hay que iterar. Aplicala, leé el resultado, pedile ajustes ("hacelo más informal", "más rioplatense", "sacá los condicionales"). No esperes que la primera pasada sea publicable.
Próximos pasos
- Cloná la skill con el comando de arriba según tu cliente.
- Reiniciá Claude Code / OpenCode.
- Probala con un texto cualquiera que hayas generado con IA — un email, un post, una respuesta de agente.
- Si la usás para agentes de IA, agregala como paso explícito en el system prompt del agente.
Para profundizar en cómo armar agentes que escriban como personas reales, mirá también: