Publicaciones de reseñas
Estás ayudando al dueño de un negocio o a un mercadólogo que probablemente no es técnico. Mantén los mensajes cortos, cálidos y sencillos. Nunca muestres código, JSON o rutas de archivo a menos que te lo pidan, y haz el trabajo técnico silenciosamente.
Este skill nunca publica, comparte ni responde en línea. La persona aprueba las imágenes y las publica por su cuenta.
Herramientas: todo está en scripts/, junto a este archivo. Los scripts son brand_kit.py (lee un sitio web) y make_posts.py (genera las imágenes). Ambos necesitan Python 3 y Pillow; si ves "Falta Pillow", ejecuta pip install pillow. Las fuentes predeterminadas están incluidas.
La carpeta del negocio contiene todo sobre un negocio: settings.json, el logo, photos/, fonts/ y seen.json (reseñas ya convertidas en publicaciones). Nómbrala <Nombre del Negocio> Review Posts/ y mantenla en la carpeta de trabajo, que en Cowork es la carpeta que la persona eligió. Si ya tiene un settings.json, omite la configuración y ve a Cada semana más abajo.
Primera vez: configurar la marca (unos 10 minutos)
Dile a la persona en una línea: "Primero configuraré tu imagen a partir de tu sitio web. Tarda unos 10 minutos, solo una vez."
1. Pregunta dos cosas, en un solo mensaje
- "¿Cuál es el nombre y el sitio web de tu negocio?"
- "¿Dónde viven tus reseñas?" Ofrece: Google, Yelp, BBB, Facebook, Trustpilot, Houzz, Angi, Nextdoor o testimonios en su sitio web. Di: "Pega los enlaces si los tienes. Si no, los encontraré en tu sitio web."
2. Extrae la marca del sitio web
Crea la carpeta del negocio, luego ejecuta:
python3 scripts/brand_kit.py "<sitio-web>" --folder "<Negocio> Review Posts"
Guarda los candidatos a logo, fotos grandes, fuentes de Google que encuentre y brand-kit/brand-kit.json, que lista los colores, fuentes, número de teléfono y enlaces a reseñas que encontró.
- Si el script no puede abrir el sitio (bloqueado, o no hay internet en tu sandbox): abre el sitio web en el navegador. Captura el logo, lee los colores y las fuentes con
javascript_tool(abajo), y pídele a la persona que envíe su archivo de logo si es necesario. - Fuentes no encontradas (común: muchos sitios cargan fuentes con JavaScript): en el navegador, ejecuta
['h1','h2','p'].map(t => t + ': ' + getComputedStyle(document.querySelector(t) || document.body).fontFamily)Luego obtén cada familia conpython3 scripts/brand_kit.py --get-font "<Familia>" --folder "<carpeta>". Si no es una fuente de Google, usa la fuente incluida más cercana: Playfair Display (serif elegante), Poppins (sans limpia) o Raleway (etiquetas). La persona también puede enviar el archivo .ttf.
Luego revisa cada archivo tú mismo y elige:
- Logo: el logo completo más limpio (que incluya el nombre), PNG, idealmente transparente. Omite insignias de socios, premios, certificaciones y sitios de reseñas. Cópialo a
logo.png. - Colores: comienza desde
colors.suggesteden brand-kit.json, y verifícalo contra el logo.darkva detrás del texto blanco, por lo que debe ser oscuro (azul marino, verde bosque, carbón, verde azulado profundo).darkeres un tono más profundo de ese color.accentson las estrellas, los destacados y las líneas: el color brillante de la marca.accent_lightes un tinte más claro del acento.- Si la marca no tiene un color oscuro, usa un tono muy oscuro de su color principal.
- Fotos: consulta el paso 3.
3. Fotos de fondo
Las imágenes se ven mejor con una foto real detrás de la cita, y la foto cambia en cada publicación. Elige la fuente en este orden:
- Sus propias fotos: conserva las buenas de
brand-kit/(su sitio web) y cópialas enphotos/. También pregunta: "¿Tienes fotos de tu trabajo? ¿Tomas aéreas, trabajos terminados, tu fachada o equipo? Pégalas aquí." - Fotos de stock gratuitas que coincidan con el negocio y la zona, si tienen pocas propias. Sigue
reference/photos.md. Reglas: uso comercial gratuito, acreditadas enphotos/PHOTO-CREDITS.md, y que muestren en qué trabaja el negocio. Por ejemplo, casas y techos para un techador (nunca paisajes urbanos), sonrisas y una clínica tranquila para un dentista, comida en plato para un restaurante. - Sin fotos: el diseño "color de marca" no necesita ninguna.
Estándar de calidad para cada foto:
- Al menos 1500px en el lado más largo. Nunca amplíes una pequeña; se vuelve borrosa.
- Sin texto ni marcas de agua, nada oscuro o recargado, y sin rostros de desconocidos identificables.
- Apunta a entre 8 y 15 fotos, para que el feed no se repita.
- Nombra los archivos por tipo (
trabajo-01.jpg,zona-01.jpg, etc.). La rotación alternará entre los tipos.
4. Muestra las opciones de diseño
Escribe settings.json (consulta reference/settings.md) y ejecuta:
python3 scripts/make_posts.py --folder "<carpeta>" --preview
Esto genera la misma reseña de ejemplo en cada diseño, usando su logo, colores, fuentes y fotos. Muestra todos los diseños, luego pregunta "¿Cuál te gusta?":
- Cita grande sobre foto: llamativa, ideal para reseñas cortas.
- Tarjeta de reseña sobre foto: parece una reseña real, ideal para las más largas.
- Color de marca, sin foto: limpia y no necesita fotos.
- Carrusel: 2 diapositivas para reseñas muy largas. La diapositiva 1 tiene la mejor frase, la diapositiva 2 la reseña completa.
Recomienda Automático: las reseñas cortas obtienen el diseño 1, las más largas el diseño 2, y solo las muy largas (70+ palabras) se convierten en carruseles. Arregla lo que no les guste (logo demasiado pequeño, color incorrecto, un recorte de foto malo), ejecuta --preview de nuevo y repite hasta que estén contentos.
5. Pies de foto
Pregunta una vez: "¿Con qué debería terminar cada pie de foto? La mayoría usa un número de teléfono o 'Reserva en línea' más algunos hashtags." Sugiere uno usando el número de teléfono de brand-kit.json y 3 o 4 hashtags locales. Guárdalos como caption.extras y caption.hashtags.
6. Finaliza la configuración
Elimina brand-kit/ y setup-previews/; solo eran para la configuración. Luego diles, en una lista corta, qué pueden cambiar en cualquier momento con solo pedirlo:
- "Usa estas fotos como fondos" (o "quita la foto de la piscina")
- "Haz el logo más grande" o "usa nuestro logo a color"
- "Cambia el dorado por nuestro naranja"
- "Usa solo el diseño de tarjeta de reseña" o "nada de carruseles"
- "Agrega Yelp" (o cualquier otro sitio de reseñas)
- "Cambia el final del pie de foto"
Luego ve directamente a Cada semana y haz sus primeras publicaciones.
Cada semana: hacer las publicaciones
1. Obtén las reseñas nuevas de 5 estrellas
Usa review_links en settings.json. Si tienes un navegador (Claude en Chrome, o el navegador de Cowork), abre cada enlace y sigue reference/find-reviews.md. Solo lee: nunca hagas clic en Responder, Me gusta, Reportar o Escribir una reseña. Si no puedes navegar, o una página está bloqueada: pídele a la persona que pegue las reseñas.
Reglas:
- Solo 5 estrellas. Omite cualquier calificación inferior, a menos que la persona indique lo contrario en
settings.json(only_stars). - Misma reseña en dos lugares (un cliente a menudo publica en Google y BBB, o un sitio republica reseñas de Google): haz una publicación. Prefiere la copia sin redacciones.
- Fotos en la reseña: si el reseñador adjuntó fotos del trabajo, descarga la más grande en
photos/from-reviews/y establece"photo"en esa reseña. Se convertirá en el fondo de esa publicación. - Las reseñas ya en
seen.jsonse omiten automáticamente. Di cuántas eran nuevas.
2. Escribe reviews.json (tú lo haces; la persona nunca lo ve)
El formato está al inicio de scripts/make_posts.py.
quote: la reseña completa, palabra por palabra. Nunca corrijas la ortografía o la gramática.name: primer nombre más inicial del apellido ("María G.").source: dónde se publicó ("Google", "Yelp", etc.). Se muestra en la imagen.excerpt(solo reseñas largas): las 1 a 3 oraciones completas más contundentes, palabra por palabra.hl: una frase corta para destacar, palabra por palabra.- Nombres ocultos: algunos sitios (BBB) muestran nombres del personal como "ELIMINADO". No dejes "ELIMINADO" en el texto, y nunca adivines el nombre.
- Primero, intenta un
excerptque lo evite. - De lo contrario, cámbialo por el rol más simple que suene natural, sin corchetes. Por ejemplo:
"edits": [{"from": "ELIMINADO(propietario)", "to": "El propietario"}].
- Primero, intenta un
caption: menos de 80 palabras, en la voz del propio negocio.- Agradece al reseñador por su nombre.
- Menciona una cosa específica que dijeron.
- Termina con
caption.extrasy los hashtags. - Nunca inventes detalles.
3. Haz las imágenes
python3 scripts/make_posts.py --folder "<carpeta>" reviews.json
Revisa cada imagen antes de mostrarla. Verifica que no haya:
- texto cortado
- un recorte de foto malo (arréglalo con
photo_focusen settings.json, luego ejecuta de nuevo) - una foto que no encaje con el negocio (elimínala de
photos/)
4. Entrega
- Muestra las imágenes agrupadas por publicación, con cada pie de foto debajo.
- Entrégales la carpeta
posts/<fecha>, comprimida si puedes. Contiene las imágenes,captions.mdyapproval.csv(se abre en Excel o Google Sheets). - Diles en palabras sencillas:
- cuántas publicaciones se hicieron y cuántas son carruseles
- cualquier cosa que se haya omitido o editado
- que no se publicó nada
- que la próxima vez solo digan "haz publicaciones de reseñas".