CommunityImagengithub.com

svg-creator

Crea diagramas de flujo y diagramas SVG con estilo dibujado a mano a partir de descripciones del usuario. Soporta especificación de relación de aspecto (16:9, 4:3, 1:1, A4 o personalizada W:H).

¿Qué es svg-creator?

Esta habilidad transforma descripciones textuales de procesos, sistemas o flujos de trabajo en diagramas SVG con un distintivo estilo dibujado a mano, como si estuvieran garabateados en una pizarra con marcadores de colores, en lugar de un diagrama corporativo rígido. Utiliza una combinación de filtros SVG (feTurbulence + feDisplacementMap) para crear bordes ondulados, patrones de sombreado diagonal (hatching) y fuentes de escritura a mano (Ma Shan Zheng para chino, Comic Sans MS para inglés). Es compatible con múltiples relaciones de aspecto (16:9, 4:3, 1:1, A4 y personalizadas) y se adapta automáticamente para usar el espacio disponible de manera natural, favoreciendo flujos horizontales en formatos anchos y flujos verticales en formatos altos. La habilidad sigue un flujo de trabajo estructurado en 6 pasos: comprender la descripción, determinar la relación de aspecto, planificar el diseño, generar el SVG, verificar todas las flechas de conexión y mostrar el resultado con opción de iterar según el feedback del usuario. Está diseñada para su uso con Claude Code, Cursor y otras herramientas de IA para desarrolladores.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

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

Creador de Diagramas de Flujo SVG Dibujados a Mano

Conviertes descripciones habladas/escritas de procesos, sistemas o flujos de trabajo en hermosos diagramas de flujo SVG con estilo dibujado a mano. El resultado debe parecer que alguien lo ha garabateado en una pizarra con rotuladores de colores, no un diagrama corporativo rígido.

Relación de Aspecto

Cada SVG debe tener una relación de aspecto definida. El usuario puede especificarla explícitamente, o se establece por defecto a 16:9 (adecuado para presentaciones). La relación de aspecto determina los atributos viewBox y width/height del elemento <svg>.

Valores predefinidos

NombreRelaciónviewBox típicoMejor para
16:916:90 0 1600 900Diapositivas, presentaciones, pantallas panorámicas
4:34:30 0 1200 900Diapositivas tradicionales, documentación
1:11:10 0 1000 1000Redes sociales, miniaturas cuadradas
A4~1:1.4140 0 1000 1414Documentos imprimibles, carteles verticales
A4-landscape~1.414:10 0 1414 1000Documentos imprimibles en formato apaisado

Relaciones personalizadas

El usuario puede especificar cualquier relación como W:H (ej., 3:2, 21:9). Calcula el viewBox escalando para que la dimensión más larga sea de ~1400-1600px y la dimensión más corta siga la relación.

Cómo afecta la relación de aspecto al diseño

  • Formatos anchos (16:9, 21:9): Favorece flujos de izquierda a derecha. Más espacio horizontal significa que puedes colocar 4-6 elementos en una fila cómodamente. El apilamiento vertical desperdicia espacio.
  • Formatos altos (A4, 9:16): Favorece flujos de arriba a abajo. Usa todo el espacio vertical; limita los elementos horizontales a 2-3 por fila.
  • Cuadrado (1:1): Equilibrado — funciona tanto para diseños radiales como para cuadrículas de 2×2/3×3. Bueno para mapas conceptuales sin una dirección de flujo fuerte.
  • 4:3: Un buen punto medio. Funciona para ambas orientaciones pero favorece ligeramente la horizontal.

Al planificar el diseño en el Paso 2, verifica siempre primero la relación de aspecto y elige una dirección de diseño que use el espacio disponible de forma natural. No fuerces un flujo de izquierda a derecha en un lienzo alto ni un flujo de arriba a abajo en un lienzo panorámico.

Comportamiento por defecto

Si el usuario no especifica una relación, usa 16:9 — funciona bien para la mayoría de los diagramas y es inmediatamente utilizable en presentaciones. Si el contenido claramente necesita una relación diferente (ej., una jerarquía muy alta), sugiere cambiarla pero no la sobreescribas en silencio.

Flujo de Trabajo General

  1. Comprender y descomponer — Analiza la descripción del usuario en módulos/pasos/actores discretos
  2. Determinar la relación de aspecto — Usa la relación especificada por el usuario, o por defecto 16:9
  3. Planificar el diseño — Decide la estructura visual, adaptándote a la relación de aspecto
  4. Generar SVG — Escribe SVG limpio con estilo dibujado a mano y viewBox correcto
  5. Verificar flechas — Autocomprueba que cada conexión entre nodos tenga una flecha visible
  6. Mostrar e iterar — Proporciona las rutas de archivo al usuario, refina según el feedback

Paso 1: Comprender y Descomponer

Cuando el usuario describe un proceso, extrae:

  • Actores/Roles — ¿Quiénes son los participantes? (ej., "PM", "Sistema", "Usuario")
  • Etapas/Fases — ¿Cuáles son las agrupaciones principales? (ej., "Fase de Entrada", "Fase de Procesamiento")
  • Pasos — ¿Cuáles son las operaciones individuales dentro de cada etapa?
  • Conexiones — ¿Cómo fluyen las cosas? ¿Secuencial? ¿Ramificación? ¿Bucles de retroalimentación?

Si la descripción es ambigua, haz preguntas aclaratorias antes de dibujar.

Paso 2: Planificar el Diseño

Elige un diseño que coincida con la estructura del proceso:

  • De arriba a abajo: Flujos secuenciales simples
  • Secciones de izquierda a derecha: Cuando hay fases distintas que se transfieren entre sí
  • Cajas agrupadas: Cuando los actores poseen diferentes conjuntos de pasos
  • Bucles de retroalimentación: Usa flechas discontinuas que rodeen el exterior

Dibuja mentalmente los contornos aproximados de las cajas delimitadoras antes de escribir las coordenadas SVG:

  • Dale a cada sección suficiente espacio (típicamente 400×500px por grupo principal)
  • Deja espacios de 40-60px entre elementos para las flechas
  • Planifica un tamaño de lienzo que quepa todo con márgenes de 30-50px

Paso 3: Generar SVG — La Técnica Central

3.1 Efecto Dibujado a Mano: La Combinación feTurbulence + feDisplacementMap

Este es el corazón del aspecto garabateado. Desplaza los píxeles usando ruido Perlin, haciendo que las líneas rectas y las esquinas afiladas parezcan dibujadas a mano.

<defs>
  <!-- Para formas (cajas, óvalos, contenedores grandes) — bamboleo moderado -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

Importante: NO apliques ningún filtro a las líneas de flecha/conector. El filtro feDisplacementMap — incluso a baja escala — hace que las líneas finas se vuelvan invisibles o se fragmenten en la mayoría de los renderizadores SVG. Las flechas deben dibujarse SIN ningún atributo de filtro. La sensación dibujada a mano para las flechas proviene de usar stroke-width="3" o más grueso, que ya se ve lo suficientemente orgánico junto a las formas filtradas.

3.2 Patrones de Sombreado Diagonal

Los patrones de líneas diagonales simulan el sombreado cruzado dibujado a mano:

<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

Superpone el patrón de sombreado con un relleno sólido semitransparente para facilitar la lectura:

<!-- Capa de sombreado -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Superposición de legibilidad -->
<rect ... fill="#dbeafe" opacity="0.25"/>

Crea un patrón de sombreado por tema de color utilizado en el diagrama.

3.3 Fuentes de Escritura a Mano — USA EXACTAMENTE ESTAS, SIN SUSTITUCIÓN

Las fuentes deben ser consistentes en todos los diagramas. Usa este bloque <style> exacto — no uses Caveat, Patrick Hand ni ninguna otra fuente. Este es un requisito estricto.

Para diagramas que contienen texto en chino:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* Texto en chino — Ma Shan Zheng estilo pincel */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* Etiquetas en inglés (nombres de código, términos técnicos como /task-add, Backlog, YAML) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Para diagramas completamente en inglés:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

Aplica class="label-en" a los elementos de texto en inglés en diagramas chinos. Nunca uses Caveat, Patrick Hand, Indie Flower ni ninguna otra fuente de escritura a mano — usa Ma Shan Zheng para chino y Comic Sans MS para inglés.

3.4 Marcadores de Flecha

Define marcadores de flecha de colores que coincidan con el tema de cada sección:

<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

Usa marker-end="url(#arrow-blue)" en las líneas de conexión. Para conexiones discontinuas (que muestran flujo indirecto/opcional), añade stroke-dasharray="14 10".

3.5 Vocabulario de Formas

ConceptoForma SVGEjemplo
Actor/Rol<ellipse>PM, Usuario, Sistema
Paso de proceso<rect rx="6">/task-add, paso de build
Contenedor/Fase<rect rx="20"> grande, con sombreadoSección "1. Introducción"
Datos/Salida<path> paralelogramoBacklog, Informe
Decisión<path> diamanteRama Sí/No
Límite exterior<rect> con stroke-dasharrayLímite del sistema, bucle de retroalimentación

3.6 Temas de Color

Cada sección/actor principal debe tener su propio color. Buenas paletas:

  • Azul: stroke="#3b82d0", fill="#dbeafe", text="#1e40af", hatch="#a0c4f0"
  • Naranja/Amarillo: stroke="#d4920a", fill="#fef3c7", text="#92400e", hatch="#f0d080"
  • Verde: stroke="#2d8a4e", fill="#d1fae5", text="#065f46", hatch="#5a9e6f"
  • Púrpura: stroke="#7c3aed", fill="#ede9fe", text="#5b21b6", hatch="#b4a0e8"
  • Gris (para conectores discontinuos): stroke="#777"

3.7 Conexión de Elementos — SIN FILTRO EN LAS FLECHAS

Esta es la sección más crítica. Las flechas que se rompen o desaparecen arruinan todo el diagrama.

Reglas:

  1. Cada conector <line> o <path> debe tener stroke-width="3" o más grueso
  2. Cada flecha debe tener un atributo marker-end="url(#arrow-xxx)"
  3. Nunca añadas filter="url(#sketchy)" o filter="url(#sketchy-line)" a ninguna flecha — los filtros hacen invisibles las líneas finas
  4. Deja un espacio de 5-10px entre el borde de la forma y el punto de inicio/fin de la flecha para que la punta de la flecha sea claramente visible
  5. Las flechas en forma de L deben terminar en el eje central del destino — si la forma de destino está centrada en x=600, el segmento final de la flecha debe terminar en x=600, no en un desplazamiento. Calcula las coordenadas del centro del destino a partir de su cx/cy (para elipses) o x + width/2, y (para rectángulos)
  6. Las etiquetas de las flechas no deben superponerse a la línea de la flecha — coloca las etiquetas 15-20px por encima o por debajo de la trayectoria de la flecha, nunca en la misma coordenada y que una flecha horizontal o misma x que una vertical
<!-- Flecha sólida (flujo directo) — SIN atributo de filtro -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#arrow-blue)"/>

<!-- Flecha discontinua (flujo indirecto/opcional) — SIN atributo de filtro -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#arrow-gray)"/>

<!-- Trayectoria en forma de L o curva — SIN atributo de filtro -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#arrow-green)"/>

Paso 4: Verificar Flechas (Autocomprobación)

Después de escribir el SVG, debes verificar cada conexión antes de guardar el archivo. Este paso detecta el defecto más común y más dañino — las flechas faltantes.

Procedimiento:

  1. Lista todas las conexiones: Vuelve a la descomposición del Paso 1 y enumera cada flecha que debería existir. Escríbelas como una lista de verificación:

    Lista de verificación de conexiones:
    - [ ] Nodo A → Nodo B (pedido)
    - [ ] Nodo B → Nodo C (procesar pedido)
    - [ ] Nodo C → Nodo D (pago exitoso)
    ...
    
  2. Para cada conexión, verifica en el SVG que haya un elemento <line> o <path> con coordenadas que vayan desde el borde inferior/derecho del nodo de origen hasta el borde superior/izquierdo del nodo de destino, Y que tenga un atributo marker-end.

  3. Comprueba la contaminación del filtro: Busca en el SVG cualquier <line o conector <path que contenga filter=. Si se encuentra, elimina el atributo filter de ese elemento.

  4. Comprueba la cordura de las coordenadas: Para cada flecha, verifica:

    • El punto de inicio (x1,y1) está cerca del borde inferior/derecho de la forma de origen
    • El punto final (x2,y2) está cerca del borde superior/izquierdo de la forma de destino
    • Para trayectorias en forma de L, el segmento final debe terminar en la x o y central de la forma de destino
    • Los puntos de inicio y final son diferentes (no líneas de longitud cero)
  5. Comprueba la colocación de la etiqueta: Para cada elemento de texto de etiqueta de flecha, verifica:

    • La y de la etiqueta está al menos 15px por encima o por debajo de la coordenada y de la flecha (para flechas horizontales)
    • La x de la etiqueta está al menos 15px a la izquierda o derecha de la coordenada x de la flecha (para flechas verticales)
    • Las etiquetas no se superponen con ninguna caja de forma

Si falta alguna conexión, añádela antes de guardar.

Paso 5: Mostrar e Iterar

  1. Comprueba si el archivo existe antes de escribir: Antes de guardar, verifica si el archivo de destino ya existe. Si es así, añade un sufijo de versión para evitar sobrescribir:

    • Primer archivo: flowchart.svg
    • Si flowchart.svg existe: guarda como flowchart-v1.svg
    • Si flowchart-v1.svg también existe: guarda como flowchart-v2.svg
    • Sigue incrementando hasta que se encuentre un nombre de archivo no utilizado
    • Usa ls o test -f para comprobar la existencia antes de escribir
  2. Escribe el SVG en la ruta de archivo determinada

  3. Convierte SVG a PNG y autocomprueba visualmente: NO abras el archivo para el usuario todavía. En su lugar, convierte e inspecciona primero el resultado:

    rsvg-convert input.svg -o output.png
    

    Luego usa la herramienta Leer para ver la imagen PNG generada. Inspecciona cuidadosamente:

    • Problemas de diseño: ¿Se superponen los elementos? ¿Algún texto está recortado o se desborda de su contenedor? ¿Hay grandes espacios vacíos o áreas apiñadas?
    • Problemas de flechas: ¿Son visibles todas las flechas? ¿Alguna flecha apunta en la dirección incorrecta, cruza formas o parece desconectada/rota?
    • Legibilidad del texto: ¿El texto es legible y no se superpone a otros elementos?
    • Equilibrio general: ¿El diagrama tiene una buena proporción dentro del lienzo?

    Si se encuentra ALGÚN problema, vuelve atrás y corrige el SVG, reconvierte y vuelve a inspeccionar. Repite hasta que el diagrama pase la inspección visual.

  4. Una vez que el diagrama pase la inspección, informa al usuario de que los archivos SVG y PNG están listos y proporciona las rutas de archivo. NO uses open — el usuario puede estar en un servidor remoto.

  5. Prepárate para el feedback — las peticiones comunes incluyen:

    • "Este cuadro es demasiado pequeño" → Aumenta las dimensiones y reposiciona
    • "La flecha está rota" → Elimina cualquier filtro de la flecha, aumenta el stroke-width
    • "La fuente no parece manuscrita lo suficiente" → Verifica la importación de Google Fonts, comprueba la cadena exacta del font-family
    • "El color es demasiado claro/oscuro" → Ajusta la opacidad y los colores del stroke
    • Reorganización del diseño → Recalcula las coordenadas

Errores Comunes

  • Flechas que desaparecen: El problema #1. NUNCA apliques filter a <line> o <path> de flecha. El filtro de desplazamiento hace invisibles los elementos finos. Solo las formas (<rect>, <ellipse>, <path> de contenedor) deben tener filtros.
  • Inconsistencia de fuentes: Usa siempre Ma Shan Zheng para chino, Comic Sans MS para inglés. Nunca sustituyas con Caveat, Patrick Hand, Indie Flower, etc.
  • El texto no parece escrito a mano: La importación de @import de Google Fonts requiere conexión a internet.

Skills relacionados