CommunityImagemgithub.com

schemdraw — Esquemas Científicos Editáveis com Rastreabilidade…

Gera diagramas e gráficos científicos editáveis e rastreáveis à fonte: extrai entidades e relações direcionadas do material, desenha como SVG em camadas com texto selecionável, mapeia legenda/cores aos dados de origem e exporta PDF+PNG em resolução de revista.

O que é schemdraw — Esquemas Científicos Editáveis com Rastreabilidade…?

O schemdraw é uma skill especializada para agentes de IA (como Claude Code, Cursor ou Codex) que precisam produzir figuras científicas precisas, editáveis e em conformidade com requisitos de exportação. Ela previne o problema comum de gerar imagens bonitas, mas com relações incorretas entre entidades, nomes inventados ou legendas inconsistentes com os dados. A skill suporta a criação de diagramas de mecanismos, fluxogramas científicos e gráficos de barras a partir de um arquivo de caso (`/input/case.json`), processando o material em quatro fases: extração de entidades/relações (com proveniência textual), desenho de SVG em camadas com texto selecionável e setas codificadas por tipo de relação, exportação para PDF vetorial e PNG em alta resolução (300 DPI) via LibreOffice e PyMuPDF, e validação rigorosa de rastreabilidade, consistência legenda-dados e existência dos arquivos de exportação. O resultado final inclui sempre o SVG editável e os PDF/PNG de exportação, garantindo que cada elemento da figura possa ser rastreado até sua fonte original.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iakRulan/schemdraw/tree/HEAD

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

schemdraw — Esquemas Científicos Editáveis com Rastreabilidade de Fonte

Caminho do script: Esta skill está instalada em /skills/weekly-skill/, o caminho absoluto do script é /skills/weekly-skill/scripts/ (o diretório de trabalho é /app/work, não use caminhos relativos).

Produza uma figura que seja correta, editável e compatível com exportação: cada entidade/relação rastreia até o material, a legenda corresponde aos dados, o texto permanece selecionável e as exportações atendem à resolução alvo. O modo de falha que esta skill existe para prevenir: uma imagem bonita com relações de entidades erradas, nomes de genes ou concentrações inventados, uma legenda que discorda dos dados e uma saída apenas bitmap que não pode ser editada.

Método em uma linha: extrair entidades/relações do material → organizá-las como um SVG em camadas (agrupado, texto selecionável, direção da seta por tipo de relação) → construir o gráfico a partir dos mesmos dados de origem com uma legenda/mapa de cores explícito → exportar PDF+PNG → validar a rastreabilidade e o contrato de exportação.

Quando usar

  • Entrada: um arquivo de caso (padrão /input/case.json) com o material científico, listas opcionais de entidades/relações, dados de gráfico e especificações de exportação.
  • Saída: em /app/output — figure.svg, chart.svg, figure.pdf, figure.png, entities.json, export_report.json, validation.json, result.json.
  • O SVG é a fonte editável; PDF/PNG são exportações.

Pipeline (executar em ordem)

Fase 1 — Extrair e desenhar

python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
  • Lê cada material (texto/Markdown), mescla as entities/relations fornecidas com relações extraídas de padrões: X activates|promotes|enhances Y, X inhibits|suppresses|blocks Y, X -> Y, X --| Y, X binds|interacts with Y, X contains|includes Y.
  • Cada relação carrega provenance (text-pattern + a citação fonte) ou vem da lista fornecida.
  • Escreve entities.json e um figure.svg em camadas: <g id="arrows"> com data-source/data-target/data-type, <g id="nodes"> com um grupo por entidade e rótulos <text>. A cor/traçado da seta codifica o tipo de relação (verde = ativação, vermelho = inibição, tracejado = contenção).
  • Se o caso tem dados de gráfico, escreve chart.svg cujas barras carregam data-label/data-value e cuja legenda usa o mesmo índice de paleta das barras.

Fase 2 — Exportar

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

LibreOffice headless converte SVG → PDF (vetorial, texto selecionável); PyMuPDF rasteriza PDF → PNG na DPI solicitada. Escreve export_report.json. Se o LibreOffice estiver ausente, o relatório informa e o status se torna partial — nunca uma falha silenciosa.

Fase 3 — Validar

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

Verifica:

  1. cada ponto final de relação é uma entidade declarada (sem setas soltas);
  2. cada relação tem proveniência ou uma citação fonte;
  3. rótulos e valores da legenda do gráfico correspondem exatamente aos dados de origem;
  4. o SVG tem <text> (selecionável) e ≥2 camadas;
  5. as exportações PDF e PNG existem e o PNG não é suspeitamente pequeno.

Fase 4 — Copiar entregáveis

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 é escrito por validate.py; copie-o também se presente

Regras que devem ser mantidas

  1. Entidades vêm do material. Nenhum nome de gene, concentração ou ponto de tempo inventado; qualquer coisa que o modelo adicionar deve ser referenciada e marcada.
  2. Direção da relação é dado. A activates B é desenhado A → B, nunca invertido; o tipo de seta segue o tipo de relação.
  3. Legenda ⇄ consistência dos dados. Rótulos e cores da legenda vêm do mesmo array que as barras; alterar os dados altera a legenda.
  4. Fonte editável + exportação conforme. Sempre entregar o SVG (editável) e o PDF/PNG (exportação) juntos.
  5. Exportação é verificada, não presumida. DPI, incorporação de fonte e existência de arquivo são registrados; uma exportação falha é reportada.

Tratamento de exceções

SituaçãoComportamento
Sem material / vaziolista de entidades vazia; SVG ainda escrito com um título
Ponto final de relação desconhecidomantido em entities (adicionado a partir do padrão) e desenhado
Dados de gráfico ausenteschart.svg ignorado; entities.json.chart_svg = null
LibreOffice ausentePDF/PNG ausentes, export_report.status = partial, limitação registrada
Sem relaçõesSVG apenas com nós; validação anota 0 relações

Autoverificação

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'])"

valid: true é obrigatório; o modelo deve preencher qualquer entidade/relação que o extrator determinístico perdeu, sempre com uma fonte.

Habilidades Relacionadas