robcsaszar/prose

Redacción de Textos (Prose)

Dos modos. Detecta el correcto antes de hacer cualquier otra cosa.

Detección de Modo

Modo Borrador — el usuario tiene un tema, un resumen o un esquema y quiere que se escriba contenido nuevo. Modo Revisión — el usuario tiene un texto existente y quiere que se mejore, se humanice o se puntúe.

Si es ambiguo: pregunta — «¿Quieres que escriba contenido nuevo, o que revise/reescriba algo que ya tienes?». Si el usuario no responde, el modo por defecto es Borrador.

---

Calibración de Voz

Antes de redactar o reescribir, pide una muestra de voz si el usuario no ha proporcionado una. Para objetivos de formato corto (mensajería instantánea, correos de menos de 200 palabras): omite la calibración de voz a menos que el usuario ya haya proporcionado una muestra.

«Comparte 1-3 párrafos de tu propia escritura que sientas que son más tuyos. Igualaré tu ritmo de oraciones, elección de palabras y hábitos estructurales.»

Analiza la muestra para:

• Tendencia en la longitud de las oraciones (contundente / analítica / mixta)
• Cómo comienzan (primero la afirmación, primero la historia, primero los datos, primero el contexto)
• Hábitos de puntuación (paréntesis, dos puntos, punto y coma)
• Frases recurrentes o tics verbales
• Cómo terminan (principio, desafío, pregunta abierta, acción)
• Palabras que nunca usan

Persistiendo el perfil. Después de analizar una muestra, ofrece guardar el resultado para que futuras sesiones omitan la recalibración: completa references/voice-profile-template.md y escríbelo en references/voice-profile.md dentro de la carpeta de la habilidad (si la carpeta es de solo lectura, muestra el perfil completado para que el usuario lo guarde). Si references/voice-profile.md ya existe, léelo completo antes de redactar o reescribir; anula las convenciones predeterminadas (tolerancia a guiones largos, estilo de comillas, frases favoritas, registros). Ante «aprende también de este texto»: añade observaciones fechadas al perfil existente; los conflictos se resuelven hacia la muestra más reciente. Un perfil nunca puede anular la disciplina de los hechos, la accesibilidad ni las reglas NUNCA.

Si no hay muestra ni perfil guardado: procede con la voz predeterminada — consulta references/drafting-core.md § «Voz predeterminada». Para blogs, ensayos, opiniones o escritura personal, consulta también references/personality-and-soul.md — una voz predeterminada limpia aún puede sonar sin alma sin ella. Si el texto se publicará bajo el nombre del usuario, menciona que la salida no calibrada tiene una voz predeterminada genérica y ofrece calibración — una vez por conversación, luego déjalo.

---

Modo Borrador

Fase 0 — Comprender antes de escribir

Pregunta antes de redactar:

1. ¿Qué necesita hacer o sentir el lector después de leer? (determina la adecuación al medio y la audiencia)
2. ¿Qué sorprendería realmente a este lector — qué cree que ya sabe que está incompleto?
3. ¿Cuál es el único trabajo de este texto — informar, persuadir, instruir, entretener o convertir?
4. ¿Qué registro se ajusta al contexto — formal, casual, técnico, conversacional — y se mantendrá estable?
5. Línea conductora — un ejemplo concreto, caso o consecuencia que pueda tener un peso real

Si es orientado a tareas: la respuesta o la siguiente acción van primero. Si es de formato largo: elige la línea conductora y un ancla concreta antes de redactar.

Antes de redactar, pregúntate: ¿cuál es el ejemplo concreto o la consecuencia única que podría sostener esta pieza? Si no puedes nombrarlo, no estás listo para redactar.

LECTURA OBLIGATORIA antes de redactar algo de más de 200 palabras: → references/drafting-core.md — reglas fundamentales y patrones específicos del medio

Para objetivos de Documentación o Creativos, también lee las reglas de reescritura de ese canal antes de redactar; ambas suspenden los valores predeterminados que se aplican en cualquier otro lugar: → references/channel-rules.md § Documentación / § Creativo

NO cargues references/ai-patterns-universal.md durante el borrador; es solo para revisión.

Fase 1 — Redactar

Escribe para ajustarte al contexto real, no a un ideal abstracto de «buena escritura».

Principios activos:

• Cada párrafo sustancial lleva al menos un ancla concreta (nombre propio, número específico, cita directa, decisión nombrada, detalle verificable). Para blogs, artículos y redes sociales. Para mensajería instantánea y correos cortos: una ancla por mensaje es suficiente.
• Sin afirmaciones vagas: «muchos», «varios», «amplias implicaciones», «cambios significativos» no pasan la prueba del ancla.
• Usa palabras sencillas; repite la palabra común cuando es la palabra correcta; prefiere verbos sobre nominalizaciones.
• Mantén el registro estable; adecúa el formato al medio.

Fase 2 — Revisar

OBLIGATORIO: Realiza las comprobaciones requeridas después de redactar. → references/required-checks.md

Si hay un shell disponible, ejecuta también el escáner determinista en el borrador; la lucha contra la vaguedad se aplica a la escritura nueva, no solo a las revisiones:

python3 scripts/slop-scan.py --channel <medium> draft.md

Cada ruta de script y referencia en esta habilidad es relativa al directorio de la habilidad, no al directorio de trabajo. Instalado como complemento, los dos rara vez son iguales: resuelve scripts/slop-scan.py con respecto al directorio desde el que se cargó este SKILL.md. Trata «archivo no encontrado» como un problema de ruta que hay que solucionar una vez, no como «no hay shell»; pasar a la capa manual en silencio omite toda la pasada determinista.

Corrige los residuos incondicionalmente. Verifica cada marca de frase contra las reglas de falsos positivos antes de cambiarla (la palabra marcada puede ser simplemente la palabra correcta). Las notas de estructura se someten al mismo criterio que la comprobación requerida 5.

Si la pieza aún se siente fuera de lugar después de las comprobaciones requeridas (solo trabajos largos): → references/long-form-diagnostics.md

Cuando los ejemplos de revisión ayudarían: → references/examples.md

---

Modo Revisión / Humanización

NO cargues references/drafting-core.md durante el Modo Revisión/Humanización; es solo para borradores.

Paso 0 — Detección automática del tipo de contenido

Clasifica el canal antes de ejecutar cualquier comprobación. Indica la detección al principio de la revisión.

Correo electrónico — tiene: línea de asunto / fórmula de saludo (Hola Nombre, Estimado Nombre) / solicitud explícita + estructura de despedida Redes sociales — tiene: una oración por línea en todo el texto / hashtags / llamada a la acción de participación al final / menos de 3000 caracteres sin encabezados Mensajería instantánea — tiene: @menciones / referencias a canales / tono casual / menos de 500 caracteres / sin saludo ni despedida Documentación — tiene: procedimientos numerados / verbos de paso imperativos / bloques de código, comandos CLI o claves de configuración / tablas de API, parámetros u opciones / sin narración en primera persona Creativo — tiene: diálogo con puntuación de habla / estructura de escena, estrofa o guion / narración con personajes nombrados / saltos de línea usados para el ritmo en lugar de estructura de lista Publicación de blog — tiene: encabezados / 3000+ caracteres de prosa estructurada / múltiples párrafos desarrollados

Comprueba Documentación y Creativo antes que Blog. Ambos tienen encabezados y párrafos desarrollados, por lo que un manual o una escena también coincidirán con las señales de Blog, y Blog es el valor predeterminado incorrecto para cualquiera de los dos.

Si un canal coincide claramente: indica la detección y continúa. Si es ambiguo (las señales entran en conflicto o ninguna se activa): pregunta — «¿Qué formato es? ¿Publicación de blog, redes sociales, correo electrónico, mensajería instantánea, documentación o creativo?». No continúes hasta que se responda.

Paso 1 — Escaneo de patrones de IA

Primero la pasada determinista. Si hay un shell disponible, guarda el texto en un archivo y ejecuta:

python3 scripts/slop-scan.py --channel <detectado> file.md

Los nombres de los canales se asignan a valores de marca: Publicación de blog → blog, redes sociales → social, correo electrónico → email, mensajería instantánea → im, documentación → docs, creativo → creative. Cada canal suprime las reglas que su medio legítimamente rompe, por lo que pasar el incorrecto produce tanto falsos positivos como señales perdidas.

El escáner informa de marcas mecánicas (residuos, frases formulaicas, tipografía) y métricas de estructura (monotonía de oraciones, párrafos uniformes, confianza uniforme, presupuesto de aforismos, ejecuciones de anáfora, párrafos etiquetados ordinalmente, conceptos acuñados, duplicación textual) con una salida estable y repetible. Pasa --allow <id-regla> para cualquier cosa que el perfil de voz o el medio permitan legítimamente. Sin shell: aplica references/formula-watchlist.md manualmente como capa mecánica.

Segundo, la pasada de juicio. LECTURA OBLIGATORIA — primero los marcadores universales: → references/ai-patterns-universal.md

Luego carga los marcadores específicos del canal: → references/ai-patterns-channels.md

Aplica los marcadores universales a TODO el contenido. Aplica los marcadores específicos del canal solo para el tipo detectado. Enumera cada elemento marcado (aciertos del escáner y marcas de juicio) con la cita exacta y su ubicación.

Paso 2 — Verificación adversaria

Cada marca del Paso 1 debe sobrevivir a una defensa antes de entrar en el informe. Para cada marca, argumenta el caso más sólido de que es un FALSO POSITIVO, utilizando las reglas «Qué NO marcar» en ai-patterns-universal.md:

• ¿Está la frase dentro de una cita, título, nombre propio o un ejemplo que se está discutiendo en lugar de usar?
• ¿Es claramente la palabra correcta aquí, aparece una vez, sin un grupo de otras señales a su alrededor?
• ¿Es una convención del medio (estructura en documentos, saludos en correos electrónicos) o está explícitamente permitida por el perfil de voz?
• ¿Es la marca «estructural» la forma correcta para este género (especificación, manual, página de referencia)?

Veredicto por marca: CONFIRMADO (la defensa falla) o DESCARTADO (razón de una línea). Solo las marcas confirmadas continúan. Los residuos (artefactos de chat, marcadores de posición, fragmentos de seguimiento) siempre se confirman — no hay uso legítimo.

Este paso existe para proteger la prosa real: sobreditar un texto que estaba bien es un fracaso tan grande como pasar por alto una señal.

Paso 3 — Verificación de originalidad

Marca si el contenido:

• Podría haber sido escrito por cualquiera con un motor de búsqueda (sin autoridad ganada, sin experiencia específica)
• No tiene experiencia de primera mano, historia de cliente o evidencia concreta en ninguna parte
• Hace el mismo punto dos veces sin añadir profundidad
• Recicla el marco de la industria («el futuro de X es Y»)
• Le falta el factor «solo yo podría escribir esto»

Redes sociales adicional: marca los anuncios de productos disfrazados de lecciones; historias personales con conclusiones de galleta de la fortuna.

Paso 4 — Puntuación

LECTURA OBLIGATORIA para las dimensiones de puntuación por canal: → references/channel-rules.md

Proporciona una justificación de una oración para cada puntuación. Si la similitud con IA es baja pero la dimensión de sustancia también es baja — Credibilidad de Dominio (blog/redes sociales), Claridad (correo electrónico/mensajería instantánea), Finalización de Tarea (documentación) o Moderación (creativo) — márcalo explícitamente. El contenido es limpio pero hueco.

Paso 5 — Informe de revisión estructurado

LECTURA OBLIGATORIA para la estructura del informe: → references/review-report-template.md

Informa solo de las marcas confirmadas; indica el número de marcas descartadas en una línea.

Paso 6 — Reescritura

Elige primero el alcance de la edición (elige tú mismo si el usuario no indicó uno; di cuál elegiste si es importante):

• Edición libre (por defecto para «humaniza esto») — las frases vacías se eliminan, no se reformulan; la longitud puede reducirse notablemente.
• Edición cuidadosa (el texto debe llenar un espacio: documento de cliente, formato fijo) — la estructura sobrevive; la longitud se mantiene entre el 80 y el 110% del original.
• Edición mínima (solo a petición expresa) — toca solo las construcciones inequívocas de IA.

Reglas universales de reescritura:

1. Nunca añadas ideas que no estén en el original; nunca elimines sustancia.
2. Reemplaza cada frase de IA marcada con lenguaje natural.
3. Varía la longitud de las oraciones: mezcla líneas cortas y contundentes con otras más largas y analíticas.
4. Reemplaza los comienzos genéricos con un gancho específico (historia, dato, afirmación contraria).
5. Reemplaza las conclusiones resumidas con un desafío, un principio o una pregunta abierta.
6. Rompe el ritmo uniforme de los párrafos: algunos cortos, otros largos.
7. Si faltan ejemplos concretos: deja [AÑADE EJEMPLO ESPECÍFICO DE TU EXPERIENCIA] — nunca inventes.
8. Editar no es verificar hechos: una afirmación que el texto no respalda no es necesariamente falsa — el autor puede tener datos más allá del texto. Suaviza la redacción a lo que el texto pueda soportar, o marca que la versión pública necesita pruebas. No elimines en silencio la afirmación como no verificada.

Excepciones de canal a las reglas 3-6. Estas cuatro son reglas de ritmo de prosa y dos canales no las quieren:

• Documentación — no varíes la longitud de las oraciones, rompas el ritmo de los párrafos, reemplaces una apertura con un gancho ni conviertas un resumen final en una pregunta abierta. La forma uniforme es lo que hace que un procedimiento sea fácil de seguir, y una especificación que termina con una provocación ha fracasado. Las reglas 1, 2, 7 y 8 aún se aplican.
• Creativo — la regla 5 se invierte: una línea final que declara el significado de la pieza es la señal, así que córtala en lugar de reemplazarla con un principio o un desafío. Las reglas 3 y 6 son decisión del escritor, no tuya.

Para blogs, ensayos, opiniones o escritura personal (no contenido enciclopédico, técnico, legal o de referencia): LECTURA OBLIGATORIA → references/personality-and-soul.md — eliminar patrones de IA produce una prosa limpia; esta sección es lo que hace que suene a alguien.

LECTURA OBLIGATORIA para las reglas de reescritura específicas del canal: → references/channel-rules.md

Bucle de eliminación. Una sola pasada de reescritura no es el estado final. Itera hasta que el texto sobreviva tanto una comprobación determinista como una adversaria, hasta 3 rondas:

1. Reescribe aplicando las marcas confirmadas y las reglas anteriores.
2. Vuelve a escanear — ejecuta scripts/slop-scan.py en la reescritura (mismo conjunto --allow). Cualquier residuo = arréglalo inmediatamente. Cualquier nueva marca de frase = arréglala o justifícala.
3. Procesa — cámbiate de bando: argumenta el caso más sólido de que la reescritura sigue siendo generada por IA. Verifica específicamente contra las señales de segundo orden en references/ai-patterns-universal.md § Parte 5 — una pasada de limpieza tiende a producirlas: confianza uniforme, un cierre aforístico en cada párrafo, «Eso no es X. Eso es Y», sin holgura en ninguna parte, vulnerabilidad performativa (una admisión que no le cuesta nada al escritor) y suspense fabricado que ocupa el lugar de los ganchos que acabas de eliminar. Cita la evidencia en una línea cada una.
4. Si la acusación tiene fundamento, corrige y repite desde el paso 2. Si no la tiene, o después de 3 rondas, detente.

Criterios de salida: el escáner informa de 0 residuos; las marcas restantes del escáner tienen cada una una justificación de una línea (convención del medio o perfil de voz); la acusación de IA no encuentra ninguna nueva señal que justifique otra ronda. Si hay un shell disponible, la comprobación determinista debe ser el mismo comando que se ejecutó en el paso 2. El usuario debe ver el texto limpio antes de que le digas que lo está.