Sobre el proyecto
avoid-ai-writing es una habilidad de escritura portátil para agentes de IA que audita y reescribe prosa para eliminar patrones comunes de escritura de IA, a menudo llamados "AI-ismos". Está diseñada para funcionar con herramientas compatibles con agentskills.io, incluyendo Claude Code, OpenClaw, Hermes, Cursor y OpenAI Codex, y también se empaqueta como plugin para ChatGPT y Codex.
La habilidad opera en tres modos. El modo de reescritura, el predeterminado, marca patrones de IA, aplica hasta dos pasadas de edición, verifica el resultado cuando es posible y devuelve una única versión final. El modo de detección marca patrones sin reescribir, separando problemas claros de juicios subjetivos, lo cual es útil cuando los patrones pueden ser intencionales o al auditar contenido que no debe alterarse. El modo de edición realiza cambios mínimos y específicos en el lugar en un archivo de prosa, preservando pasajes que ya suenan humanos; rechaza código fuente, configuración y datos generados porque las reescrituras de prosa pueden corromper contenido estructurado.
Una decisión de diseño clave es el límite de edición de dos pasadas, configurable con --iterate 1 o --iterate 2. La primera pasada reescribe, y la segunda puede detectar patrones que sobrevivieron o reparar problemas de preservación, deteniéndose temprano cuando no queda una edición justificada dentro del alcance. La habilidad informa cuántas pasadas usó y cualquier hallazgo intencional, protegido o no resuelto. Un perfil de voz opcional (casual, profesional, técnico, cálido, directo) controla cómo debe sonar la prosa, separado del perfil de contexto de audiencia.
El repositorio incluye un catálogo de patrones sustancial. Documenta 74 categorías de patrones con ejemplos de antes/después, cubriendo patrones de contenido como inflación de importancia y atribución vaga, patrones de lenguaje como evitación de cópulas y ciclos de sinónimos, patrones de estructura como formato y frases de transición, patrones de comunicación como artefactos de chatbot y tono adulador, y meta-patrones como uniformidad rítmica y sobre-pulido. Adiciones posteriores cubren detección estructural, huellas de herramientas de IA como marcadores de posición sin rellenar y marcado de citas de chatbot, señales de registro conversacional, encuadre de publicaciones compartidas, candor narrado e hifenización innecesaria. Una tabla de reemplazo de palabras de 112 entradas abarca tres niveles, con el Nivel 1 dividido en marcadores de frecuencia y ediciones de claridad para que las correcciones de verbosidad no empujen un documento hacia una clasificación de IA.
Un motor detector determinista incluido proporciona verificación mecánica. Implementa 53 categorías de tipos, diferenciándose intencionalmente del recuento del catálogo de prosa porque divide los niveles de vocabulario y añade señales estilométricas y de huellas como distribución de puntuación, entropía de palabras funcionales y detección de trucos de evasión. El detector puede puntuar un archivo o texto canalizado desde la línea de comandos, filtrar prosa en GitHub Actions o enganches de pre-commit, y ejecutarse sobre MCP. Los dos recuentos están mapeados en la documentación del detector y no pretenden reconciliarse.
La instalación varía según la plataforma. Los usuarios pueden clonar el repositorio en el directorio de habilidades de un agente, usar un archivo dist autocontenido, instalarlo como plugin de Claude Cowork, instalarlo desde ClawHub para OpenClaw, colocar una regla portada en Cursor, o colocar la habilidad en el directorio .agents/skills de Codex. El paquete de plugin de OpenAI proporciona siete habilidades enfocadas, incluyendo un enrutador, detector, reescritor que preserva la voz, editor de archivos, verificador de preservación y revisor de falsos positivos. El proyecto tiene licencia MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.