CommunityImagengithub.com

review-posts

Convierte las reseñas nuevas de 5 estrellas de cualquier negocio (Google, Yelp, BBB, Facebook, Trustpilot, Houzz, Angi, su propio sitio web o texto pegado) en imágenes listas para Instagram (1080x1350) con la marca del negocio, pies de foto y una hoja de aprobación.

¿Qué es review-posts?

Este skill para agentes de IA (como Claude Code, Cursor o Codex) automatiza la creación de publicaciones visuales para Instagram a partir de reseñas positivas de clientes. Está diseñado para que el agente pueda hacer todo el trabajo técnico (raspar un sitio web para extraer logo, colores, fuentes y fotos; generar imágenes con Pillow; escribir pies de foto) mientras el negocio solo se comunica en lenguaje natural. En la primera ejecución, el agente configura la marca del negocio leyendo su sitio web y preguntando preferencias de diseño. Luego, cada semana, busca reseñas nuevas de 5 estrellas en las fuentes configuradas (Google, Yelp, etc.) o acepta texto pegado, y produce imágenes en 4 formatos (cita grande sobre foto, tarjeta de reseña sobre foto, color sólido sin foto, o carrusel para reseñas largas). El agente nunca publica nada; entrega los archivos para que el usuario los revise y publique manualmente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/javiervillag/review-posts/tree/HEAD/review-posts

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. "¿Cuál es el nombre y el sitio web de tu negocio?"
  2. "¿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 con python3 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.suggested en brand-kit.json, y verifícalo contra el logo.
    • dark va detrás del texto blanco, por lo que debe ser oscuro (azul marino, verde bosque, carbón, verde azulado profundo).
    • darker es un tono más profundo de ese color.
    • accent son las estrellas, los destacados y las líneas: el color brillante de la marca.
    • accent_light es 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:

  1. Sus propias fotos: conserva las buenas de brand-kit/ (su sitio web) y cópialas en photos/. También pregunta: "¿Tienes fotos de tu trabajo? ¿Tomas aéreas, trabajos terminados, tu fachada o equipo? Pégalas aquí."
  2. 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 en photos/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.
  3. 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?":

  1. Cita grande sobre foto: llamativa, ideal para reseñas cortas.
  2. Tarjeta de reseña sobre foto: parece una reseña real, ideal para las más largas.
  3. Color de marca, sin foto: limpia y no necesita fotos.
  4. 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.json se 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 excerpt que 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"}].
  • 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.extras y 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_focus en settings.json, luego ejecuta de nuevo)
  • una foto que no encaje con el negocio (elimínala de photos/)

4. Entrega

  1. Muestra las imágenes agrupadas por publicación, con cada pie de foto debajo.
  2. Entrégales la carpeta posts/<fecha>, comprimida si puedes. Contiene las imágenes, captions.md y approval.csv (se abre en Excel o Google Sheets).
  3. 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".

Skills relacionados