writing-shape

Visión general de writing-shape

writing-shape es una habilidad de redacción conversacional para convertir un “montón” de markdown en un artículo publicable, una decisión estructural a la vez. Es ideal para redactores, marketers técnicos y editores que ya tienen material de base, pero necesitan ayuda para encontrar el enfoque, la apertura y la forma final de la pieza.

Para qué sirve

Usa writing-shape cuando la tarea no sea “escribir desde cero”, sino “dar coherencia a este material bruto”. Funciona muy bien con notas de entrevistas, limpieza de transcripciones, fragmentos de borradores y textos técnicos que necesitan una narrativa más sólida antes de poder cerrarse.

En qué se diferencia

La habilidad writing-shape hace más que resumir notas fuente. Te pide elegir entre varias aperturas candidatas y luego construye el artículo párrafo a párrafo mientras debate la estructura sobre la marcha. Eso la vuelve útil para textos en los que la secuencia, el énfasis y el formato importan tanto como los hechos.

Mejor encaje y límites

Encaja muy bien con Technical Writing cuando quieres un artículo legible a partir de una entrada desordenada, pero no sustituye el criterio experto del tema. Si necesitas prosa pulida sin conversación, un prompt genérico puede ser más rápido; si necesitas un proceso editorial guiado, writing-shape es la mejor instalación.

Cómo usar writing-shape

Instalación y preparación de la sesión

Instálalo con npx skills add mattpocock/skills --skill writing-shape. Después, inicia la sesión dándole el archivo markdown en bruto y la ruta del artículo objetivo, o pídele que elija una si todavía no la has definido. La habilidad espera que el material de origen se trate como de solo lectura y que el archivo del artículo se vuelva a leer antes de cada escritura.

Qué entrada proporcionar

El uso más sólido de writing-shape empieza con tres cosas: las notas brutas, la audiencia prevista y el resultado deseado del artículo. Por ejemplo, “convierte estas notas en una guía práctica para nuevos platform engineers” es mejor que “mejóralo”, porque le da a la habilidad una tesis, un lector y un nivel de detalle para optimizar.

Flujo de trabajo recomendado

Empieza con el archivo fuente, léelo de principio a fin y deja que la habilidad proponga 2–3 aperturas candidatas. Elige la apertura que encaje con la función real del artículo y sigue luego paso a paso, preguntando qué necesita leer el usuario a continuación. Este ciclo es donde writing-shape aporta más valor: mantiene el artículo anclado mientras te deja reorganizar la estructura a medida que el borrador toma forma.

Archivos que debes leer primero

Abre primero SKILL.md y después revisa cualquier guía cercana del repositorio que la habilidad mencione, como README.md, AGENTS.md y metadata.json si existen. En este repositorio, el valor principal está en SKILL.md en sí, así que la decisión práctica no es “buscar ayudas ocultas”, sino “entender el ciclo de redacción y adaptarlo con limpieza”.

Preguntas frecuentes sobre writing-shape

¿writing-shape es solo para entradas en markdown?

Está diseñado en torno a archivos markdown, pero el “montón” puede ser una transcripción, notas o prosa en bruto convertida a markdown. El requisito clave es que la fuente se pueda leer como un cuerpo completo de material antes de empezar a darle forma.

¿En qué se diferencia de un prompt normal?

Un prompt normal suele pedir un borrador terminado en una sola pasada. writing-shape guía una sesión editorial iterativa: la elección de la apertura, la secuenciación de párrafos y los debates sobre el formato ocurren durante el proceso, lo que normalmente produce un artículo más intencional a partir de entradas desordenadas.

¿writing-shape es bueno para principiantes?

Sí, si la persona puede aportar material fuente y responder algunas preguntas editoriales. Es especialmente útil cuando los principiantes saben qué tienen, pero todavía no cómo organizarlo en un artículo convincente.

¿Cuándo no debería usarlo?

No uses writing-shape cuando el contenido ya esté muy bien estructurado, cuando no haya un verdadero montón de material que transformar o cuando necesites un resumen puntual en lugar de un artículo en desarrollo. Aporta más valor cuando el borrador todavía necesita decidir su forma, no solo limpieza.

Cómo mejorar writing-shape

Dale un encargo editorial más preciso

Los mejores resultados de writing-shape llegan con una promesa clara: para quién es el artículo, qué problema resuelve y en qué tipo de pieza debe convertirse. Si puedes nombrar la audiencia y el resultado desde el principio, la habilidad puede elegir una mejor apertura y mantener alineados los párrafos posteriores.

Aporta mejor material de base

Un modo de fallo común: el material fuente es demasiado amplio, repetitivo o mezcla investigación no relacionada. Antes de invocar la habilidad, recorta el ruido evidente, reúne juntos los fragmentos markdown más relevantes y etiqueta las secciones si la fuente contiene varios temas. Una mejor entrada reduce los borradores dispersos y hace que la conversación de estructuración sea más decisiva.

Itera sobre la estructura, no solo sobre la redacción

Si el primer borrador no encaja, no pidas solo “mejor prosa”. En su lugar, ajusta la tesis, reordena los hitos del texto o cambia las expectativas de formato del artículo. writing-shape mejora más cuando corriges primero la forma del argumento y después las frases.

Conserva el archivo del artículo

Como la habilidad espera que el documento del artículo se vuelva a leer antes de cada escritura, los cambios deben quedarse en ese archivo y no gestionarse en el chat. Ese hábito protege las ediciones del usuario, hace la colaboración más segura y mantiene writing-shape útil para sesiones largas de redacción.