Communitygithub.com

flowy

Habilidade de design. Crie, leia e atualize arquivos HTML de diagramas Flowy para fluxogramas, diagramas de sistema e wireframes/mockups de interface. Use esta habilidade sempre que o usuário pedir para diagramar um fluxo, visualizar arquitetura, esboçar uma interface, planejar visualmente um recurso, criar um wireframe, mapear um processo, criar um diagrama HTML ou mencionar "flowy". Use também quando o usuário fizer referência a arquivos de diagrama .html existentes no diretório docs/diagrams/ ou pedir para atualizar/modificar um diagrama.

O que é flowy?

Flowy é uma habilidade nativa de IA que gera diagramas SVG interativos em arquivos HTML autônomos. Cada arquivo contém CSS, JavaScript e dados do diagrama incorporados, sem dependências externas — basta dar um duplo clique para abrir no navegador. A habilidade suporta fluxogramas (topo-para-baixo) e mockups de interface do usuário (também topo-para-baixo, com anotações à direita). Ela segue um esquema claro com metadados, nós e arestas, oferecendo regras detalhadas de renderização para tipos de nós (caixa, círculo, losango, nota, grupo) e arestas (curvas bezier cúbicas com setas). O layout é controlado por espaçamentos padrão e uma paleta de cores para ações, decisões, erros, terminais e grupos. Além de criar, a habilidade permite ler e modificar diagramas existentes, extraindo o objeto DIAGRAM do código JavaScript inline. A ferramenta é totalmente offline, sem dependências de npm ou CDN, e recomendada para desenvolvedores e usuários de agentes de IA que precisam visualizar arquiteturas, fluxos de trabalho, wireframes de UI ou processos de forma rápida e integrada ao ambiente de desenvolvimento.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vandezand-ctrl/workflow-automation-skills/tree/HEAD/skills/flowy

Perguntar na sua IA favorita

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

Documentação

Flowy, Habilidade de Diagramas Nativa de IA

Flowy gera arquivos HTML autônomos que renderizam diagramas SVG interativos. Cada arquivo inclui CSS, JavaScript e dados do diagrama incorporados, sem dependências. Basta dar um duplo clique para abrir em qualquer navegador.

Locais dos Arquivos

  • Diagramas: docs/diagrams/*.html (ex.: docs/diagrams/upload-flow.html). Crie a pasta no primeiro uso; ela pode ainda não existir. Se um projeto já mantiver diagramas em outro local, siga a convenção desse projeto.
  • Modelo HTML: ${CLAUDE_SKILL_DIR}/references/html-template.html, o renderizador canônico e o único arquivo de referência que esta habilidade fornece. O caminho resolve para a própria pasta desta habilidade, onde quer que ela esteja instalada (plugin, pessoal ou projeto), então não depende do projeto atual.

Deliberadamente não há arquivo de esquema, pasta de exemplos ou editor visual. Versões anteriores desta habilidade apontavam para flowy/schema.ts, flowy/examples/, flowy/editor.html e um repositório Flowy no disco. Nada disso existe, os caminhos estavam desatualizados e segui-los era perda de tempo. O modelo HTML acima é a fonte da verdade para a estrutura; leia-o antes de escrever um diagrama.

Pré-voo

Antes de criar ou editar um diagrama Flowy:

  1. Leia ${CLAUDE_SKILL_DIR}/references/html-template.html para ter o código do renderizador atual
  2. Liste diagramas existentes em docs/diagrams/ para evitar conflitos de nomenclatura
  3. Se estiver atualizando um diagrama existente, leia-o primeiro e extraia o objeto DIAGRAM

Esquema

Cada diagrama é um objeto JavaScript com três campos:

{
  meta: { title, description, type, tags[], created, updated },
  nodes: [...],
  edges: [...]
}

meta

CampoTipoObrigatórioNotas
titlestringsimTítulo legível por humanos
descriptionstringnãoO que o diagrama mostra
typestringsim"flowchart" ou "ui-mockup"
tagsstring[]nãoPara organização
createdstringnãoData ISO (YYYY-MM-DD)
updatedstringnãoData ISO, defina como hoje ao criar/atualizar

nodes

CampoTipoObrigatórioNotas
idstringsimúnico, snake_case (ex.: "step1_upload")
typestringsim"box", "circle", "diamond", "note", "group"
labelstringsimTexto principal exibido na forma
sublabelstringnãoTexto secundário mostrado no tooltip ao passar o mouse
position{ x, y }simCanto superior esquerdo em pixels
size{ width, height }simDimensões em pixels
styleobjectnãoVeja os campos de estilo do nó abaixo
groupstringnãoid do nó de grupo pai (apenas agrupamento visual)

Campos de estilo do nó: fill, stroke, strokeWidth, color (texto), fontSize, borderRadius, opacity

edges

CampoTipoObrigatórioNotas
idstringsimúnico (ex.: "e_upload_to_extract")
sourcestringsimid do nó de origem
targetstringsimid do nó de destino
labelstringnãotexto na seta (ex.: "sim", "erro")
sourceHandlestringnão"top", "right", "bottom" (padrão), "left"
targetHandlestringnão"top" (padrão), "right", "bottom", "left"
styleobjectnãoVeja os campos de estilo da aresta abaixo

Campos de estilo da aresta: stroke, strokeWidth, strokeDasharray, markerEnd

Regras de Renderização de Nós

TipoElemento SVGDetalhes
box<rect>Cantos arredondados via rx/ry de borderRadius. Padrão: 8px
circle<ellipse>cx = x + width/2, cy = y + height/2, rx = width/2, ry = height/2
diamond<polygon>4 pontos: centro-superior, centro-direito, centro-inferior, centro-esquerdo
note<path>Retângulo com canto dobrado (superior-direito). Tamanho da dobra: 12px
group<rect>Borda tracejada (stroke-dasharray: 6,3). Renderizado ATRÁS de todos os outros nós. Rótulo no canto superior esquerdo. Baixa opacidade

Regras de Renderização de Arestas

  1. Calcule o ponto de origem: centro do lado do identificador especificado do nó de origem (padrão: inferior)
  2. Calcule o ponto de destino: centro do lado do identificador especificado do nó de destino (padrão: superior)
  3. Desenhe uma curva bezier cúbica (comando C) com pontos de controle deslocados em 50px na direção do identificador
  4. Adicione uma ponta de seta usando uma definição SVG <marker>
  5. Se strokeDasharray estiver definido, renderize como linha tracejada
  6. Se label existir, renderize no ponto médio da curva bezier com um pequeno retângulo de fundo branco atrás dele

Regras de Layout

Direção do Fluxo

  • Fluxogramas: De cima para baixo (padrão)
  • Mockups de UI: De cima para baixo dentro de um contêiner de grupo, anotações à direita

Espaçamento

  • Mínimo de 70px vertical entre centros dos nós
  • Mínimo de 60px horizontal entre nós paralelos
  • Preenchimento do grupo: 40px dentro dos limites do grupo

Losangos de Decisão

  • Ramo esquerdo = caminho principal / sim
  • Ramo direito = caminho secundário / não / erro

Notas de Erro/Aviso

  • Coloque à DIREITA do fluxo principal
  • Conecte com arestas vermelhas tracejadas (strokeDasharray: "6,3", stroke: #991b1b)

Tamanhos Padrão

TipoLarguraAltura
box20050
circle9040
diamond12060
note18044

Paleta de Cores

PropósitoPreenchimentoTraçadoTexto
Ações#ffffff#2d6a4f#1f2937
Ações primárias#d1fae5#065f46#065f46
Decisões#fef3c7#92400e#1f2937
Erros#fee2e2#991b1b#991b1b
Terminais#40916c#2d6a4f#ffffff
Grupos#f5f5f2#e6e4df#374151
Informação/secundário#dbeafe#1e40af#1e40af
Arestas padrão,#6b7280,

Estrutura do Arquivo HTML

Cada arquivo HTML Flowy segue esta estrutura. Leia a referência do modelo HTML para o código completo e funcional.

<!DOCTYPE html>
<html lang="pt-BR">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>{título do diagrama}</title>
  <style>
    /* Todo CSS inline, barra de ferramentas, tela, tooltips, destaques de seleção */
  </style>
</head>
<body>
  <div id="toolbar">
    <!-- [Ajustar] [-] 100% [+]   Título  selo   [Baixar JSON] -->
  </div>
  <div id="canvas-wrap">
    <svg id="canvas">
      <defs><!-- marcadores de ponta de seta --></defs>
      <g id="diagram-root"></g>
    </svg>
  </div>
  <div id="tooltip"></div>
  <script>
    const DIAGRAM = { meta: {...}, nodes: [...], edges: [...] };
    // Código de renderização + interatividade
  </script>
</body>
</html>

Barra de Ferramentas

  • Fixa no topo, 48px de altura, fundo branco, borda inferior
  • Esquerda: Botão Ajustar à Tela, diminuir zoom, % de zoom, aumentar zoom
  • Centro: Título do diagrama (negrito) + selo de tipo (pílula cinza)
  • Direita: Botão Baixar JSON (azul)

Interatividade (tudo JS puro)

  1. Zoom: A roda do mouse escala o viewBox do SVG. Faixa: 0,2x a 5x. Zoom em direção à posição do cursor.
  2. Pan: Arraste com o clique no canvas vazio para transladar o viewBox.
  3. Passar o mouse: Ao passar o mouse sobre um nó, seu sublabel é exibido em um tooltip perto do cursor.
  4. Clique: Clicar em um nó o destaca (borda azul) e todas as arestas conectadas. Clique no espaço vazio para desmarcar.
  5. Ajustar à Tela: O botão calcula a caixa delimitadora de todos os nós e define o viewBox com 60px de preenchimento.
  6. Baixar JSON: Serializa o objeto DIAGRAM como JSON formatado e dispara o download do arquivo.

Criando um Novo Diagrama

Quando o usuário pedir um novo fluxograma ou mockup de UI:

  1. Leia o template: Leia o arquivo de referência do modelo HTML para obter o código do renderizador atual
  2. Analise a solicitação: Identifique nós (etapas, decisões, erros) e arestas (conexões)
  3. Atribua posições usando as regras de layout (grade de cima para baixo, espaçamento padrão)
  4. Aplique cores usando a paleta de cores (terminais = verde, decisões = âmbar, erros = vermelho, etc.)
  5. Gere o arquivo HTML completo: Copie a estrutura do modelo, substitua o objeto DIAGRAM pelos novos dados
  6. Salve em docs/diagrams/{nome-em-kebab-case}.html
  7. Informe ao usuário: "Abra docs/diagrams/{nome}.html no seu navegador para visualizar o diagrama."

Nomenclatura de Arquivos

  • Local: docs/diagrams/{nome}.html
  • Formato: kebab-case.html (ex.: docs/diagrams/upload-flow.html, docs/diagrams/checkout-screen.html)
  • Defina meta.updated para a data ISO de hoje

Atualizando um Diagrama Existente

Quando o usuário pedir para modificar um diagrama:

  1. Leia o arquivo HTML existente
  2. Extraia o objeto DIAGRAM do bloco <script>
  3. Modifique os nós/arestas conforme solicitado
  4. Atualize meta.updated para a data de hoje
  5. Regenere o arquivo HTML completo com os dados atualizados (releia o template para o renderizador mais recente)
  6. Salve de volta no mesmo caminho

Lendo um Diagrama

Quando solicitado a analisar ou descrever um diagrama:

  1. Leia o arquivo HTML
  2. Encontre o bloco const DIAGRAM = { ... };
  3. Liste os nós por tipo e rótulo
  4. Trace as arestas para descrever o fluxo em linguagem natural
  5. Destaque os pontos de decisão e seus ramos

Exemplos

"Crie um fluxograma para o fluxo de login"

Ação: Criar docs/diagrams/login-flow.html com:

  • start (círculo, verde) → enter_credentials (caixa) → validate (losango, âmbar)
  • validate → sim/esquerda → dashboard (círculo, verde)
  • validate → não/direita → show_error (nota, vermelha) → seta tracejada de volta para enter_credentials

"Atualize o mockup de configurações para adicionar uma opção de modo escuro"

Ação: Leia docs/diagrams/settings-screen.html, extraia DIAGRAM, adicione um novo nó de caixa "section_dark_mode" com rótulo "Modo Escuro" posicionado após a seção Tema, atualize meta.updated, regenerar o HTML.

"Adicione tratamento de erros à etapa 3 do fluxo de upload"

Ação: Leia o HTML, encontre a etapa 3 no array de nós, adicione um nó de nota de erro à direita, adicione uma aresta vermelha tracejada da etapa 3 para a nota de erro, regenerar.

Restrições Importantes

  • Zero dependências: Sem npm, sem links CDN, sem scripts/estilos externos
  • Funciona offline: Deve renderizar sem acesso à internet
  • Arquivo único: Cada diagrama é UM arquivo .html
  • Nativo do navegador: Apenas HTML5 padrão, CSS3, SVG e JavaScript ES6+ puro
  • Amigável para LLM: O JSON do DIAGRAMA deve ser formatado de forma limpa, não minificado

Automatutenção

Se você descobrir um padrão útil ao criar diagramas, um novo truque de layout, uma cor que funciona bem para um propósito específico, uma melhoria de renderização, atualize este arquivo de habilidade para incluí-lo. Mantenha a habilidade precisa e acionável.

Habilidades Relacionadas