CommunityImagengithub.com

coloring-book

Ayuda a crear un libro para colorear completo, desde la generación de escenas hasta la preparación para su publicación en Amazon KDP, utilizando IA o GPU local.

¿Qué es coloring-book?

Esta skill guía al usuario a través del proceso completo de creación de un libro para colorear de bajo contenido, desde la idea hasta la subida a Amazon KDP. Comienza generando N escenas basadas en el tema, con indicaciones detalladas para cada página y escenas de repuesto. Luego elige el método de generación de imágenes: API de Gemini (recomendado), app gratuita de Gemini (manual) o GPU local con ComfyUI/FLUX. Cada imagen pasa por un control de calidad automatizado que verifica el grosor de las líneas, la ausencia de grises y la densidad del contenido; las que no pasan se rechazan y se regeneran, con hasta 3 intentos por página antes de recurrir a escenas de repuesto. Finalmente, se maqueta el PDF interior y la portada, y se guía al usuario para rellenar manualmente el formulario de KDP en su navegador, respetando las políticas de KDP y declarando el uso de IA. La skill se apoya en scripts Python y documentación detallada en la carpeta de referencias, y enfatiza la transparencia y la no automatización de pasos que requieren decisión humana.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Owen-gh/coloring-book-skill/tree/HEAD

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

coloring-book: Del tema a un libro para colorear (incluyendo preparación para publicación en KDP)

Lee esto primero (Declaración)

  • Esta es una demostración de un flujo de trabajo personal que documenta los pasos que una persona (nosotros) siguió para hacer dos libros. No es asesoría legal ni un método oficialmente soportado por KDP.
  • Antes de comenzar, pídele al usuario que lea y confirme los términos de KDP por su cuenta: uso de la cuenta, uso de herramientas de terceros, divulgación de contenido generado por IA, y normas de contenido. Los términos cambian; lo que dice la documentación oficial de KDP en ese momento es lo que cuenta.
  • Hasta donde sabemos, KDP no tiene una API pública para subir libros; la parte de subida se hace rellenando un formulario web en el navegador del usuario ya iniciado sesión, con el usuario presente, verificando y confirmando antes de enviar. No garantizamos ningún resultado de cuenta.
  • Las cifras en este documento son "valores que registramos, verifícalos tú mismo" (o marcados como "probado por nosotros"). No presentes lo que no está marcado como un hecho al usuario.
  • Divulgación de IA: Las imágenes del libro son generadas por IA; KDP exige que se declare con sinceridad. Tú (la IA) no debes ocultarlo por el usuario ni inventar una respuesta que "suene mejor".

Lo que debes hacer (Resumen)

El usuario solo dice "Hazme un libro para colorear (tema)". Sigue los pasos ① a ⑤ en orden y al final de cada uno informa al usuario del avance. En cada paso donde haya algo que solo un humano pueda hacer, detente y pídeselo al usuario; no lo hagas por él.

PasoContenidoArchivo de detalle
①Escenas: Genera N indicaciones de escena basadas en el tema, más escenas de repuestoreferences/prompt-principles.md
②Generación de imágenes: Elige el método y genera cada páginaEste documento, paso ②
③Control de calidad: Mide cada imagen, rechaza y redibuja, usa repuestos hasta que todo esté completoreferences/qc-rules.md, scripts/qc_page.py
④Maquetación: Crea el PDF interior y el PDF de portadareferences/book-spec.md, scripts/make_pdf.py
⑤Subida a KDP: Guía al usuario para rellenar el formulario KDP en su navegador ya iniciado sesiónreferences/kdp-upload-fields.md

Preparación previa

  • Se necesita Python 3 con Pillow, numpy y scipy (qc_page.py usa numpy/scipy; make_pdf.py solo usa Pillow). Si faltan paquetes, pide permiso al usuario para instalarlos en un entorno virtual.
  • Para verificar PDFs se pueden usar pdfinfo y pdftoppm (poppler); Pillow solo puede escribir PDFs, no abrirlos.
  • Los scripts se ejecutan como python scripts/xxx.py, con la ruta relativa a la carpeta de esta skill.

Paso 0: Confirmación inicial (pregunta al usuario todo de una vez)

  1. ¿Cuál es el tema? (Si es muy vago, da 2 o 3 opciones para que elija; no lo decidas por tu cuenta).
  2. Número de páginas: Por defecto 96 páginas, 8x8 pulgadas cuadradas (= 47 imágenes; ambos libros los hicimos así). "Páginas" se refiere a páginas impresas; "imágenes" = páginas / 2 - 1 (KDP mínimo 24 páginas = 11 imágenes); si el usuario dice "24 páginas", confirma a cuál se refiere.
  3. ¿Qué método de generación de imágenes tienes? (Gemini API, app gratuita de Gemini manual, o GPU local con ComfyUI/FLUX) → Ver paso ②. 3b. ¿Para quién es el libro? Espaciado (para niños) o denso (para adultos), elige uno (corresponde a --mode sparse|busy en el control de calidad, por defecto espaciado). No hemos hecho un libro completo para niños; revisa las imágenes para confirmar.
  4. Nombre del autor (el que aparecerá en la portada) y título del libro: Decididos por el usuario.
  5. ¿Su cuenta de KDP tiene ya configurados los datos fiscales y de pago? (Si no, dile que debe hacerlo él mismo; no afecta los primeros cuatro pasos).
  6. ¿Cuántos libros en rústica de KDP ha creado esta semana? (Nuestro registro: límite de 2 por semana, ver kdp-upload-fields.md. Consulta la normativa vigente de KDP).

Crea una carpeta de trabajo (nombre personalizado) con los siguientes archivos: scenes.json, spares.json, book.json, raw/, pages/, log.csv, needs_human.txt. Las plantillas de los tres archivos de registro están en references/templates/ (book.json, log.csv, needs_human.txt); los límites de caracteres de los campos están en references/kdp-upload-fields.md.

Paso ①: Indicaciones de escena

Sigue references/prompt-principles.md:

  • Genera N frases de escena (N = páginas / 2 - 1; 96 páginas = 47) más aproximadamente 1/6 de escenas de repuesto (nosotros usamos 47 principales con 8 de repuesto).
  • Cada frase de escena = prefijo fijo + frase de esa escena (el lugar lo determina el tema, usa {theme} / {place} como marcadores de posición, no nombres de pueblos concretos) + Square 1:1 image.. Núcleo del prefijo: líneas negras gruesas, sin sombras de color, sin tramas de grises, sin bloques negros sólidos, sin texto ni personas, objetos pocos y grandes, que toda la página tenga algo para colorear, no repetir el mismo objeto.
  • Los protagonistas y lugares no se repiten en todo el libro; la composición y las estaciones rotan; la cantidad de objetos aumenta gradualmente.
  • Guárdalos como scenes.json (un array de cadenas) y spares.json. Muestra la lista de escenas al usuario y espera su confirmación antes de empezar a generar imágenes (generar imágenes cuesta dinero o tiempo de GPU).

Paso ②: Generación de imágenes

Cómo elegir (pregunta al usuario y elige una opción):

  • A. Modelo de imágenes Gemini (API o web): Nosotros usamos Nano Banana 2.1 (código del modelo gemini-nano-banana-2.1), proporción 1:1 (cuadrado), luego redimensionamos a 2400 px. La ruta API permite generar varias en paralelo (nosotros usamos 4 en paralelo); la ruta web requiere que el usuario pegue las indicaciones y tú le ayudes a organizar los archivos. El usuario debe proporcionar su propia clave API o iniciar sesión; la clave solo se guarda en variables de entorno, no se escribe en ningún archivo ni se pega de vuelta en el chat.
  • C. App gratuita de Gemini (manual): Tú das las indicaciones completas de cada página, el usuario las pega en la app de Gemini y guarda las imágenes en la carpeta especificada (raw/). Tú ejecutas el paso ③ (control de calidad) para cada imagen; si se rechaza, dale al usuario el motivo (la línea que imprime qc_page.py en lenguaje natural) y pídele que la regenere. Nota: es manual; la cuota gratuita tiene un límite diario (verifícalo por tu cuenta, nosotros no lo hemos verificado); el modelo de la app puede diferir del nuestro; revisa la calidad de las imágenes visualmente; el control de calidad, la maquetación y la subida los haces tú; no es totalmente automático y con muchas imágenes lleva mucho tiempo.
  • B. GPU local (ComfyUI + modelos tipo FLUX): Probamos FLUX.2 Klein 4B y otro flujo flux3, tamaño de imagen 1088 x 1088. Nuestro registro: Klein tiende a dar líneas delgadas en páginas de detalle medio (medición 2–4 px, umbral 4.5); para esas páginas aplicamos un postprocesado de "expandir línea negra 1 px, máximo 3 veces" y volvimos a medir el grosor. Los dos libros que publicamos usaron imágenes de la ruta Gemini; la ruta local no la hemos usado para un libro publicado, así que se considera no verificada. Si tienes Gemini, úsalo primero.
  • Costos: Esta skill no requiere suscripción a ningún software de generación de imágenes. Gemini API se paga por uso (la versión web depende de tu plan); la GPU local no requiere suscripción pero necesita tu propia tarjeta gráfica y electricidad; ejecutar la skill requiere Claude Code (según el plan de Anthropic). Evalúa los costos por tu cuenta.
  • Especificaciones mínimas (probadas por nosotros): Cuadrado 1:1; imagen original al menos ~1000 px (nosotros usamos 1088 en la versión local; en Gemini, el tamaño por defecto durante la verificación era 1024, y al final lo ampliamos a 2400; las líneas seguían suaves y pasaban el control de calidad); página final 2400 x 2400 px (8 pulgadas x 300 dpi), blanco y negro puro.
  • Imagen de portada principal: Con el mismo modelo, genera una imagen a color cuadrada; nosotros usamos tamaño 2K; la indicación pide "25% superior en blanco crema tranquilo, sin texto, sin personas". Durante la verificación nos encontramos con: escribir solo "top 25% blank" hizo que el modelo dividiera la imagen en dos mitades; lo cambiamos a "single continuous scene (not split, not tiled)… compose in the lower three quarters; the top quarter is a flat plain cream color" y funcionó correctamente. Después de generar, revisa la imagen visualmente para confirmar que realmente tiene espacio en blanco arriba antes de pasarla a make_pdf.py.
  • Si eliges la opción A y el usuario no tiene clave API: No sugieras buscar métodos para eludir las restricciones; pídele que use la versión web a la que tenga acceso, genere las imágenes una por una, las guarde en raw/, y tú te encargues del control de calidad.
  • Antes de usar un servicio de imágenes con IA, pídele al usuario que confirme que los términos del servicio permiten uso comercial y publicación de libros (Gemini, FLUX.2 Klein 4B tienen sus propios términos; nosotros leímos que FLUX.2 Klein 4B es Apache-2.0; el usuario debe verificarlo por su cuenta).

Paso ③: Control de calidad, hasta que todo esté completo

Al usuario solo explícale cuatro puntos:

  1. Solo blanco y negro, sin grises ni grandes bloques negros.
  2. Líneas suficientemente gruesas.
  3. La página no está vacía: cada una de las nueve celdas de la cuadrícula debe tener algo, al menos 3 elementos para colorear por celda.
  4. Si no pasa, se redibuja automáticamente (máximo 3 intentos por página; si aún así falla, se usa una escena de repuesto). (El script también revisa más detalles, no es necesario explicarlos uno por uno.)

Cada página:

Máximo 3 intentos:
  Genera imagen -> raw/sNN_try.png
  python scripts/qc_page.py [--mode sparse|busy] raw/sNN_try.png   # Si se rechaza, imprime el motivo en lenguaje natural
  Si el script da PASS, revisa la imagen visualmente: ¿la cabeza y el cuerpo del protagonista son claros? ¿Se fusiona con objetos redondos? (references/qc-rules.md)
  Si todo pasa: python scripts/qc_page.py --finalize raw/sNN_try.png pages/cNN.png ; escribe en log ; break
  Si no: escribe en log (incluyendo el motivo); descarta la imagen original; redibuja con la misma indicación de escena (en la ruta manual: pídele al usuario que la regenere)
Si después de 3 intentos no pasa: usa la siguiente escena de repuesto de spares.json; si se agotan los repuestos y aún no pasa: anótalo en needs_human.txt y continúa con la siguiente página.
  • No modifiques los umbrales para que pase, ni selecciones manualmente imágenes que no cumplan los requisitos para ponerlas en pages/. Si needs_human.txt no está vacío, detente y preséntaselo al usuario para que decida.
  • Puedes generar varias imágenes en paralelo; registra todo claramente (hora, página, intento, resultado, motivo).
  • Cuando termines, crea una tabla de resumen de contacto para que el usuario la vea y espera su confirmación antes de pasar al paso ④.
  • Nuestra referencia práctica: para un libro de 47 páginas, el log tuvo 90 entradas; cada página terminó con un PASS; se usaron 8 escenas de repuesto a lo largo del proceso. Es normal esperar rechazos y cambios de repuesto.

Paso ④: Maquetación y generación de PDF

Sigue references/book-spec.md (nuestras especificaciones probadas: 8x8 pulgadas, 96 páginas, 300 dpi, interior blanco y negro en papel blanco, una cara — después de cada imagen viene una página en blanco, portada con sangría de 0.125 pulgadas, lomo = páginas x 0.002252 pulgadas).

  • Ejemplo: python scripts/make_pdf.py pages/ out/ --title "..." --subtitle "..." --author "..." --blurb "..." --cover-art cover.png Produce out/interior_upload.pdf, out/cover.pdf, out/cover_preview.png.
  • --pages debe ser un número par; el número de imágenes debe ser = páginas / 2 - 1 (por ejemplo, para probar con 2 imágenes usa --pages 6; si faltan, mostrará "solo hay N imágenes"). KDP en rústica tiene un número mínimo de páginas (nosotros registramos 24, verifícalo por tu cuenta); un libro de prueba de 6 páginas no se puede subir; el script no duplica páginas para alcanzar el mínimo, y no deberías hacerlo.
  • Comportamiento del script: La página de título interior ajusta automáticamente el texto (si tiene más de 4 líneas, reduce el tamaño). El color del texto de la portada (título, subtítulo, autor) se elige automáticamente (claro u oscuro) según el fondo, con una banda semitransparente. El texto del lomo solo se muestra si --pages ≥ 79 (nuestro valor registrado; la página oficial dice 79 u 80, verifícalo por tu cuenta); si es menor, se deja en blanco y se imprime un aviso. La dirección del texto del lomo (en sentido horario, de arriba abajo) debe verificarse por tu cuenta. Aun así, revisa la vista previa de la portada para confirmar la posición.
  • También puedes escribir tu propio script, siempre que cumpla las mismas especificaciones. Una vez terminado, ábrelo y revísalo visualmente, luego muestra la vista previa al usuario.
  • El título, subtítulo, autor, descripción, palabras clave (7 grupos) y categorías (2) se escriben en book.json, y el usuario los confirma (nuestro formato está en kdp-upload-fields.md). Todo el texto se compone mediante código, no se dibuja con el modelo.

Paso ⑤: Subida (estás presente, revisando, y confirmas antes de enviar)

Sigue references/kdp-upload-fields.md. Puntos clave:

  1. Detente primero: Pídele al usuario que inicie sesión en kdp.amazon.com (incluyendo contraseña y 2FA) y que confirme que los datos fiscales y de pago están configurados. Esto lo hace él mismo; tú no debes recibir su contraseña, cookies, códigos de verificación ni documentos, ni almacenarlos.
  2. En su navegador ya iniciado sesión (por ejemplo, con una herramienta de automatización del navegador), ve a Bookshelf → Create → Paperback, y rellena campo por campo los valores de book.json. Después de cada página, informa brevemente "esta página se ha rellenado con esto", y el usuario lo confirma visualmente.
  3. Declaración de derechos de publicación (Publishing Rights): Pídele al usuario que elija y haga clic él mismo.
  4. Divulgación de contenido generado por IA: Decláralo con sinceridad. En nuestros dos libros: las imágenes son en gran parte generadas por IA con mínima edición, por lo que marcamos IA de imágenes = Many AI-generated images, with minimal or no editing; en la herramienta escribimos el nombre real de la herramienta; el texto interior solo es la página de título compuesta manualmente. En tu caso, declara según corresponda y pídele al usuario que lo confirme.
  5. Después de subir el interior y la portada, usa Launch Previewer y haz clic en Approve (probado por nosotros: sin este paso no se puede continuar).
  6. Detente antes de Publish, deja que el usuario revise todos los campos y la vista previa, y que decida si hace clic o no.
  7. Recuerda el límite semanal (nosotros registramos un máximo de 2 libros por semana; verifícalo según la normativa vigente de KDP). Haz solo un libro a la vez; no subas lotes cuando el usuario no esté presente.
  8. Si la página difiere de nuestra plantilla, o si encuentras un código de verificación, una advertencia de riesgo o una alerta de cuenta: detente y pregúntale al usuario, no intentes eludirlo.

Tono al informar al usuario

  • Usa "En nuestro flujo de trabajo..." "Según nuestras pruebas...", no digas "KDP permite", "Oficialmente soportado", "No será bloqueado", "Subida totalmente automática".
  • Si no puedes hacer algo o no lo has verificado, dilo.
  • Entrega final: pages/ (páginas finales), out/interior_upload.pdf, out/cover.pdf, book.json, log.csv, (si existe) needs_human.txt, y una lista de "cosas que el usuario debe hacer por su cuenta".

Anexo: Cosas que no hemos verificado (no afirmes al usuario)

  • Otros tamaños, papel crema, tapa dura, tamaño 8.5x11 pulgadas.
  • Si los umbrales son adecuados para estilos diferentes al de "escenas de animales adorables" (mandalas, realistas, figuras humanas); el modo "espaciado (para niños)" no lo hemos probado en un libro completo.
  • Si la revisión estructural "la IA principal mira las imágenes" coincide con los resultados de un modelo de visión externo que usamos.
  • Ventas, clasificaciones, ingresos: no ofrecemos ninguna garantía.

Skills relacionados