CommunityImagengithub.com

schemdraw

Genera esquemas científicos editables y trazables hasta la fuente: extrae entidades y relaciones dirigidas del material, dibújalas como SVG en capas con texto seleccionable, mapea leyenda/colores del gráfico a los datos fuente, exporta PDF+PNG a resolución de revista y valida que cada elemento tenga trazabilidad.

¿Qué es schemdraw?

Esta habilidad permite a agentes de IA generar esquemas científicos editables, con trazabilidad completa desde el material fuente hasta el gráfico final. Es útil para investigadores, autores de papers o divulgadores que necesitan figuras precisas (no dibujos artísticos) a partir de texto científico complejo. Funciona con Claude Code, Cursor y Codex. El proceso extrae automáticamente entidades (genes, proteínas, compuestos) y relaciones (activación, inhibición, unión, etc.) del texto de entrada, las dibuja como un SVG en capas con texto seleccionable y genera un gráfico de barras con leyenda etiquetada directamente desde los mismos datos. Luego exporta a PDF (vectorial, con texto seleccionable) y PNG a 300 DPI. Finalmente, valida que cada relación tenga origen documentado, que la leyenda coincida exactamente con los datos y que los archivos exportados existan y tengan tamaño adecuado. No está diseñado para análisis estadístico, diseño de posters, ilustraciones artísticas ni redacción de papers.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iakRulan/schemdraw/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

schemdraw — Esquemas Científicos Editables con Trazabilidad hasta la Fuente

Ruta del script: Esta habilidad está instalada en /skills/weekly-skill/, la ruta absoluta del script es /skills/weekly-skill/scripts/ (el directorio de trabajo es /app/work, no uses rutas relativas).

Produce una figura que sea correcta, editable y conforme a la exportación: cada entidad/relación se traza hasta el material, la leyenda coincide con los datos, el texto permanece seleccionable y las exportaciones cumplen con la resolución objetivo. El modo de fallo que esta habilidad busca prevenir: una imagen bonita con relaciones de entidades incorrectas, nombres de genes o concentraciones inventados, una leyenda que contradice los datos y una salida solo en mapa de bits que no se puede editar.

Método en una línea: extraer entidades/relaciones del material → organizarlas como un SVG en capas (agrupado, texto seleccionable, dirección de flecha según tipo de relación) → construir el gráfico a partir de los mismos datos fuente con leyenda explícita/mapa de colores → exportar PDF+PNG → validar trazabilidad y contrato de exportación.

Cuándo usarlo

  • Entrada: un archivo de caso (por defecto /input/case.json) con el material científico, listas opcionales de entidades/relaciones, datos del gráfico y especificaciones de exportación.
  • Salida: en /app/output — figure.svg, chart.svg, figure.pdf, figure.png, entities.json, export_report.json, validation.json, result.json.
  • El SVG es la fuente editable; PDF/PNG son exportaciones.

Pipeline (ejecutar en orden)

Fase 1 — Extraer y dibujar

python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
  • Lee cada material (texto/Markdown), fusiona las entidades/relaciones proporcionadas con relaciones extraídas mediante patrones: X activa|promueve|estimula Y, X inhibe|suprime|bloquea Y, X -> Y, X --| Y, X se une|interactúa con Y, X contiene|incluye Y.
  • Cada relación lleva procedencia (patrón-de-texto + la cita fuente) o proviene de la lista proporcionada.
  • Escribe entities.json y un figure.svg en capas: <g id="arrows"> con data-source/data-target/data-type, <g id="nodes"> con un grupo por entidad y etiquetas <text>. El color/tipo de línea de la flecha codifica el tipo de relación (verde = activación, rojo = inhibición, discontinua = contención).
  • Si el caso tiene datos de gráfico, escribe chart.svg cuyas barras llevan data-label/data-value y cuya leyenda usa el mismo índice de paleta que las barras.

Fase 2 — Exportar

python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300

LibreOffice en modo cabeza convierte SVG → PDF (vectorial, texto seleccionable); PyMuPDF rasteriza PDF → PNG a los DPI solicitados. Escribe export_report.json. Si falta LibreOffice, el informe lo indica y el estado se vuelve parcial — nunca un fallo silencioso.

Fase 3 — Validar

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work

Verifica:

  1. cada extremo de relación es una entidad declarada (sin flechas colgantes);
  2. cada relación tiene procedencia o una cita fuente;
  3. las etiquetas y valores de la leyenda del gráfico coinciden exactamente con los datos fuente;
  4. el SVG tiene <text> (seleccionable) y ≥2 capas;
  5. las exportaciones PDF y PNG existen y el PNG no es sospechosamente pequeño.

Fase 4 — Copiar entregables

mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
   /app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json lo escribe validate.py; cópialo también si está presente

Reglas que deben cumplirse

  1. Las entidades provienen del material. No se inventan nombres de genes, concentraciones o puntos de tiempo; cualquier cosa que agregue el modelo debe tener fuente y estar marcada.
  2. La dirección de la relación son datos. A activa B se dibuja A → B, nunca al revés; el tipo de flecha sigue el tipo de relación.
  3. Consistencia leyenda ⇄ datos. Las etiquetas y colores de la leyenda provienen del mismo arreglo que las barras; cambiar los datos cambia la leyenda.
  4. Fuente editable + exportación conforme. Siempre entregar el SVG (editable) y el PDF/PNG (exportación) juntos.
  5. La exportación se verifica, no se asume. Los DPI, la incrustación de fuentes y la existencia de archivos se registran; una exportación fallida se informa.

Manejo de excepciones

SituaciónComportamiento
Sin material / vacíolista de entidades vacía; el SVG aún se escribe con un título
Extremo de relación desconocidose mantiene en entities (añadido desde el patrón) y se dibuja
Datos de gráfico faltanteschart.svg se omite; entities.json.chart_svg = null
LibreOffice faltantePDF/PNG faltan, export_report.status = partial, limitación registrada
Sin relacionesSVG solo con nodos; la validación anota 0 relaciones

Autocomprobación

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"

Se requiere valid: true; el modelo debe rellenar cualquier entidad/relación que el extractor determinista haya omitido, siempre con una fuente.

Skills relacionados