CommunityImagengithub.com

paper-brush

Genera ilustraciones planas de papel recortado (retratos, avatares, personajes, escenas, iconos) como código determinista, sin modelo de imagen. Úsalo para crear un conjunto con un estilo de papel uniforme o añadir imágenes que combinen entre sí.

¿Qué es paper-brush?

Paper Brush es un renderizador determinista para ilustraciones planas de papel recortado, diseñado para equipos de desarrollo que necesitan generar imágenes consistentes y editables sin depender de modelos generativos de IA. Cada ilustración se describe como una pila de formas de papel de colores, cada una cortada a lo largo de un trazado de pluma, garantizando que la misma entrada produzca la misma salida de píxeles. Esto asegura coherencia visual en todo un conjunto y permite ajustar cualquier forma editando solo unos pocos números en el código. La herramienta se entrega como un bloque de código en `references/engine.md` que debe copiarse al proyecto con un comando `awk`, y se ejecuta con Python 3 usando las bibliotecas `numpy` y `opencv-python`. Paper Brush es ideal para equipos que trabajan con Claude Code, Cursor, Codex o cualquier agente de IA que admita flujos de trabajo deterministas y control de versiones sobre activos artísticos. El flujo de trabajo incluye la configuración de un archivo de dibujos, la elección de una cuadrícula de referencia, la creación de formas a partir de máscaras, el renderizado y la iteración hasta la aprobación. También ofrece soporte para combinar con conjuntos existentes mediante el estudio de referencias, calibración, extracción de partes reutilizables y mezcla de prueba, además de funciones reutilizables para caras como partes paramétricas y espejado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hanlianlu/paper-brush/tree/HEAD/skills/paper-brush

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

Paper brush (Pincel de papel recortado)

Un renderizador determinista para ilustraciones planas de papel recortado: cada imagen es una pila corta de formas de papel de colores, cada una cortada a lo largo de un trazado de pluma. Mismo archivo de dibujo, mismos píxeles de salida, por lo que un conjunto se mantiene coherente y cualquier forma se puede ajustar editando unos pocos números. Cualquier proporción, color de papel y tamaño.

Configuración del motor, una vez por proyecto: el renderizador se entrega como un bloque de código en references/engine.md. Cópialo con un comando, nunca volviéndolo a escribir: awk '/^```python$/{f=1;next} /^```$/{f=0} f' references/engine.md > DIR/paper.py, donde DIR es la carpeta de arte del proyecto (o una carpeta temporal); el mismo comando convierte references/example_drawings.md en un archivo de dibujos para empezar. Ejecútalo con python3 paper.py ... (necesita numpy y opencv-python). Los comandos a continuación asumen ese archivo. Si paper.py ya existe allí, reutilízalo.

El estilo (mantenlo)

Lee references/style.md antes de dibujar. En resumen: pocas formas grandes; pocos nodos con arcos largos; esquinas reales marcadas como esquinas; 2–3 tonos por material (base, sombra, a veces una luz); las sombras son formas limpias recortadas dentro de su padre, a menudo con un borde duro y otro difuminado; sin contornos alrededor de las formas; líneas solo donde habría una línea de pluma (cejas, pestañas, boca, un pliegue) y siempre afinadas; el rubor es la única borrosidad; papel blanco cálido y un grano fino y uniforme sobre todo.

Flujo de trabajo

  1. Configura un archivo de dibujos en el proyecto (por ejemplo, Tools/art/drawings.py) que contenga DRAWINGS = {"nombre": {...}}. El formato está en el docstring de paper.py (python3 paper.py sin argumentos lo imprime). Comienza desde el archivo de dibujos en references/example_drawings.md.
  2. Elige una cuadrícula de autor y, si tienes una, una imagen de referencia (un boceto, una pintura, una imagen aprobada) colocada sobre esa cuadrícula. Lee las coordenadas de los nodos a una escala conocida; una lambda pequeña como h = lambda *p: [(x/2, y/2, *r) for x, y, *r in p] convierte desde los píxeles de la referencia.
  3. Delinea las formas a partir de una máscara si es útil: haz una máscara en blanco y negro de una región (umbral de color, máscara manual) y ejecuta python3 paper.py nodes MASK.png [scale] — imprime nodos con esquinas ya encontradas. Luego adelgázalos y ordénalos a mano; el paso manual es lo que hace que se vea recortado, no trazado.
  4. Renderiza: python3 paper.py ruta/al/drawings.py OUT_DIR [nombre …] → OUT_DIR/<nombre>.png.
  5. Observa, compara, ajusta. Pon el resultado junto a la referencia (o al conjunto aprobado) al tamaño en que se verá, por ejemplo ffmpeg -i a.png -i b.png -filter_complex hstack cmp.png, y ábrelo. Corrige una cosa a la vez: un nodo, un tono, un recorte. Espera varias iteraciones; confirma cuando el propietario lo apruebe.
  6. Entrega al tamaño y formato del proyecto (reduce con Lanczos; JPEG q≈88 o PNG). Las imágenes no superan los 2K. Si el proyecto marca sus imágenes con marca de agua, sella después de la aprobación, antes de enviar.

Coincidir con un conjunto existente

Cuando las nuevas imágenes deben unirse a un conjunto que ya tiene un estilo (más avatares junto a los aprobados), el orden es primero las reglas, luego dibujar, luego iterar:

  1. Estudia las referencias y escribe las reglas. Acerca y mide: cómo se construyen los bordes, tonos por material, dónde se sitúan las formas de sombra y qué tan finas son, tamaños y posiciones de los rasgos en los ejes de la cabeza, cuánto del encuadre ocupa la cabeza, color del papel y grano.
  2. Calibra: redibuja una referencia con el pincel, ponla junto al original, ajusta hasta que coincidan.
  3. Extrae las partes que transmiten el estilo (ojos, cejas, interiores de oreja) de las referencias: python3 paper.py lift REF.png X Y [tol] --eyes x1,y1,x2,y2 imprime la forma plana debajo del píxel X,Y como nodos en los ejes de esa cabeza. Superpón para verificar; mueve la semilla si cae sobre piel.
  4. Dibuja sobre la fuente: python3 paper.py grid SOURCE.jpg grid.png da una copia cuadriculada (líneas cada 20 px, etiquetas cada 100) para leer coordenadas. Pocos nodos por forma: una cara unas 16, una masa de cabello 20–40.
  5. Prueba de mezcla antes de mostrar a nadie: intercala las nuevas imágenes con las referencias en una cuadrícula a tamaño miniatura (unos 480 px). Si se puede distinguir una nueva, no está lista. Luego verifica cada una a tamaño completo junto a su referencia más cercana.

Lo que no funciona: formas de la imaginación (todas las caras salen iguales); trazar una pintura realista por color (copia sus grumos); vectorizar automáticamente referencias (manchado); copiar posiciones de rasgos directamente de una cara realista (la boca queda demasiado baja y la cara se ve larga y vieja); formas de sombra tomadas de las áreas oscuras de una pintura (manchas).

Colocación típica de la cara en los ejes de la cabeza (mide tu propio conjunto): cejas aproximadamente y −0.8, paralelas a la línea del ojo; nariz un gancho corto en el lado lejano, x −0.3 a −0.65, y 0.45 a 1.15; boca aproximadamente 1.1 unidades de ancho en y 1.6 a 1.8, casi paralela a los ojos, ambos extremos a aproximadamente la misma altura (un extremo elevado se lee como sonrisa burlona); barbilla y 2.8 a 3.1. Dale a cada personaje su propia silueta de cabello, forma de ojo y ceja, y paleta, o el conjunto deriva hacia una sola cara. Para rizos apretados, trenzas y lana usa scallop(); para cuellos de punto ribs(); para lentes y botones oval() (from paper import scallop, ribs, oval).

Caras: partes reutilizables

Para un conjunto de caras que combinen, dale a cada dibujo "eyes": ((x, y), (x, y)). Esto define los ejes propios de la cabeza (x a lo largo de la línea del ojo, y hacia abajo de la cara, unidad = mitad de la distancia entre ojos), de modo que los rasgos se puedan escribir una vez y colocarse en cualquier cabeza:

  • {"head": True, "stroke": [...], "w": 0.12, "color": ...} — nodos en unidades de cabeza (ancho también).
  • {"part": ("nombreconjunto", "eye_l"), "fill": ..., "scale": 1.1, "shift": (0, 0.05), "turn": 4} — una parte de un archivo parts.py ubicado junto al archivo de dibujos: PARTS = {"nombreconjunto": {"eye_l": {"nodes": [...]}, ...}}, nodos en unidades de cabeza. Extrae partes una vez de imágenes aprobadas (traza la máscara de una parte con nodes, convierte a unidades de cabeza), luego cada nueva cara las reutiliza, lo que mantiene el conjunto con la misma mano.
  • "mirror": True gira una cara para mirar hacia el otro lado sin redibujarla.

Errores comunes

  • Las formas se pintan en orden; un "clip" solo ve formas ya pintadas bajo ese "name".
  • Varias capas con el mismo "name" se suman (unión), útil para un cuerpo hecho de dos piezas.
  • Los puntos de "fade" están en coordenadas de cuadrícula: fuerte en el primero, desaparecido en el segundo.
  • "soft" está en unidades de cuadrícula; úsalo solo para rubor y brillos.
  • Los dibujos pueden from paper import flow, scallop, ribs, oval: la carpeta del motor está en la ruta.
  • No dejes que un dibujo derive en muchas formas pequeñas o contornos; si un detalle necesita una línea, pregúntate si una segunda forma de tono lo expresaría mejor.

Skills relacionados