Markusgjesdal/listing-writer

Listing writer

Convierte una carpeta de archivos de producto en una ficha de tienda que dice claramente lo que el comprador recibe. La ficha se construye a partir de hechos encontrados en los archivos, no de exageraciones. Salida: listing.md junto a la carpeta del producto.

Cuándo usarlo

• Un producto digital (plantilla, guía PDF, imprimible, paquete de código, paquete de prompts o skills, hoja de cálculo) está listo y necesita texto para la tienda.
• Una ficha antigua debe reescribirse desde cero. (Para puntuar y parchear una ficha existente en su lugar, usa listing-audit si lo tienes).

Cuándo no usarlo

• El producto aún no está listo. Escribe la ficha después de que los archivos existan, para que cada afirmación pueda verificarse contra ellos.

Entradas

• Obligatorio: ruta a la carpeta del producto o al zip.
• Preguntar una vez si no se encuentra en los archivos: para quién es (una frase), precio o rango de precios, la tienda donde se publicará, y cualquier cosa que el comprador deba tener ya (software, cuenta, nivel de habilidad).
• Opcional: notas propias del usuario, una ficha anterior, una lista de capturas de pantalla, comentarios reales de clientes que el usuario pueda mostrarte (usa solo comentarios que el usuario confirme que son reales y que está permitido citar).

Pasos

1. Inventariar el producto. Enumera cada archivo que el comprador recibirá (recursivamente en carpetas y zips). Cuenta páginas, hojas, plantillas, skills, o la unidad que corresponda. Anota formatos y cualquier software requerido. Escribe esta lista primero: es la fuente de verdad para el resto.
2. Encontrar el trabajo. En una frase, indica la tarea que el comprador termina más rápido o mejor con este producto. Si no puedes, pregúntale al usuario antes de escribir nada más.
3. Rellenar templates/listing-template.md sección por sección:
   • Opciones de título (3): menos de 70 caracteres, comenzar con el resultado o el objeto, incluir el formato (ej. «Plantilla de Notion», «PDF», «paquete de skills»). Sin MAYÚSCULAS, sin muro de emojis, sin «definitivo/mejor/#1» a menos que el usuario pueda demostrarlo.
   • Resumen: una frase, menos de 160 caracteres, utilizable como descripción corta de la tienda y fragmento de búsqueda.
   • Descripción: 3 párrafos cortos: el problema en palabras del comprador, qué hace este producto al respecto, cómo se usa (pasos o un ejemplo breve).
   • Qué incluye: lista con viñetas hecha solo del inventario del paso 1, con cantidades reales.
   • Para quién es / no es: 2-4 viñetas cada una. «No es para» genera confianza y reduce devoluciones.
   • Requisitos: software, versiones, cuentas, nivel de habilidad.
   • Preguntas frecuentes: 4-6 preguntas que un comprador realmente haría (formato, devoluciones, actualizaciones, compatibilidad, licencia, soporte). Responde solo con hechos que el usuario haya confirmado; de lo contrario, marca [ASK USER].
   • Etiquetas: 8-12 frases de búsqueda en minúsculas que la gente escribiría, sin nombres de competidores o marcas a menos que sea por compatibilidad.
4. Ejecutar checklists/claims-check.md sobre el borrador y corregir cada acierto.
5. Marcar huecos. Cualquier hecho que no puedas verificar se queda como [ASK USER: ...] en el texto. No lo rellenes con una suposición.
6. Escribir listing.md, luego dar al usuario un resumen en 3 líneas de chat: título elegido, número de elementos [ASK USER], cualquier cosa de la comprobación de afirmaciones de la que no estuvieras seguro.

Salida

listing.md con secciones: Opciones de título, Resumen, Descripción, Qué incluye, Para quién es, Para quién no es, Requisitos, Preguntas frecuentes, Etiquetas, Preguntas abiertas.

Reglas

• Cada número en la ficha debe venir del inventario o del usuario.
• Sin promesas de ingresos o resultados («gana X€», «garantizado», «viral»). Describe lo que el producto hace, no lo que el comprador ganará.
• Sin reseñas, testimonios, recuentos de compradores, «tiempo limitado» o «solo quedan N» inventados.
• Los nombres de productos de otras empresas aparecen solo como hechos de compatibilidad («funciona con ...»), nunca de una manera que sugiera respaldo.
• Escribe para personas que hojean en el móvil: párrafos cortos, palabras sencillas, sin muro de negritas.
• Nunca publiques ni pegues en la tienda tú mismo. Eso lo hace el usuario.

Archivos en esta skill

• templates/listing-template.md — la estructura que se rellena para listing.md.
• checklists/claims-check.md — líneas que buscar y corregir antes de entregar.