html-view

Gera, inspeciona e exporta documentos HTML off-line de arquivo único, relatórios de dados e protótipos de interface, além de desenhar gráficos de dados SVG e diagramas estruturais.

O que é html-view?

Esta skill oferece um ambiente completo para criar, revisar e entregar artefatos HTML auto-contidos sem dependência de servidor. Ela é ideal para gerar documentos como planos técnicos, atas de reunião, relatórios de negócio, dashboards e wireframes de interface, partindo de fontes como Markdown, CSV ou JSON. Além de construção e estilização, a skill fornece um poderoso sistema de visualização de dados e diagramas, suportando diversos tipos de gráficos (KChart) e diagramas (Mermaid, nativos) para representar tendências, comparações, composições, fluxos, arquiteturas e muito mais. Funcionalidades auxiliares incluem auditoria, captura de tela, exportação para PDF/PNG, aplicação de temas e comparação de versões, garantindo que o artefato final esteja correto e visualmente consistente antes da entrega.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fengwk/html-view-skill/tree/HEAD/skills/html-view

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

HTML View

node <skill-dir>/scripts/htmlview é o ponto de entrada de comando multiplataforma; doravante abreviado como htmlview. Requer Node.js 22+; a verificação no navegador, captura de tela, exportação e renderização de gráficos independentes também requerem Chrome ou Chromium. Se o navegador não for encontrado, siga o tratamento error.next.

HTML Existente: Apenas Trocar o Tema

  • Produtos do htmlview: Para documentos, relatórios ou páginas de gráfico único, use htmlview style file.html --theme cloudmusic (consulte htmlview style --list para temas); para protótipos de interface, use --scheme ou --brand. O comando style atualiza in-loco, apenas reestruturando o invólucro e os gráficos derivados. Para gerar um novo arquivo, primeiro copie para um nome de arquivo não utilizado no mesmo diretório, execute style na cópia e, em seguida, use htmlview diff para comparar o conteúdo.
  • HTML Comum: style não aceita HTML comum. Se precisar usar o invólucro da skill, crie um novo documento temático (veja Fluxo de Documento e Componentes de Documento), migre o conteúdo existente para o novo arquivo; não reutilize o CSS e os scripts do invólucro antigo. Ao apenas alterar o estilo, mantenha os números originais, a granularidade temporal e as conclusões, não recalcule os dados nem perca detalhes dos gráficos originais para passar na verificação de exibição.

Escolha por Tarefa

Resultado Desejado pelo UsuárioAçãoQuando Expandir
Planos técnicos, relatórios, instruções, atas ou resumos de uma página, fáceis de ler e anotarPara Markdown, use doc build; para editar HTML diretamente, use doc newPrimeiro leia Fluxo de Documento; ao escrever componentes HTML manualmente, adicionar referências cruzadas ou manipular comentários, leia Componentes de Documento
Relatórios ou dashboards para verificar números de negócio, métricas e gráficosCrie um pacote de dados a partir do arquivo de resumo upstream; após data validate, execute data buildPrimeiro leia Fluxo de Relatório de Dados; ao modificar campos, métricas, gráficos ou narrativas, leia Pacote de Dados; para dashboards, leia Guia de Dashboard
Wireframes, protótipos de alta fidelidade ou maquetes para telas, estados ou fluxos de interaçãoApós ui new, preencha cada tela com controles reais e seus valoresPrimeiro leia Fluxo de Protótipo de Interface; ao selecionar componentes ou escrever interações, leia Índice de Componentes; ao definir layout, esquema de cores ou escrever componentes manualmente, leia Guia de Design de Interface; ao desenhar painéis de dados, leia Guia de Dashboard
Gráfico SVG único ou página de gráfico off-lineSelecione a família de gráficos na tabela abaixo, escreva a declaração e então viz renderPara gráficos de dados, primeiro leia Regras Gerais de Declaração, depois a família selecionada; para diagramas estruturais, leia diretamente a família correspondente
Ler, inspecionar, capturar tela ou exportar HTML localUse read, check, shot, export ou embedParâmetros e resultados de verificação em Exibição e Exportação
  • Quando o material não for uma estrutura de página pronta, como notas soltas, atas de reunião, JSON, CSV, logs, ou Markdown que precisa ser reorganizado, leia Do Material à Página antes de escrever o conteúdo.
  • Os produtos HTML são arquivos únicos que podem ser abertos off-line. Ao escrever manualmente, modifique apenas o título e o conteúdo entre <!-- htmlview:content --> e <!-- /htmlview:content -->; cada marcador é mantido uma vez. O layout, tema e scripts de execução são montados pela CLI.
  • Documentos construídos a partir de Markdown devem modificar a fonte Markdown; relatórios de dados devem modificar o pacote de dados, não o texto, gráficos ou números gerados diretamente. Dados sem fonte não devem ser inventados; dados de demonstração devem ser claramente identificados como exemplos fictícios.
  • Para sobrescrever artefatos independentes existentes, confirme o destino antes de usar --force; atualizações de documentos da mesma fonte não precisam de --force.
  • Quando --lang não for passado, os comandos de geração inferem os termos do shell (números de figuras, sumário, legendas, etc.) a partir do título e do corpo: se a contagem de palavras em inglês for pelo menos o dobro da contagem de caracteres em chinês/japonês/coreano, use inglês; caso contrário, use chinês. Para outros idiomas ou conteúdo meio a meio, passe --lang explicitamente.

Escolha o Gráfico de Acordo com o que o Leitor Quer Ver

Use gráficos estáticos por padrão. Gráficos de dados usam KChart JSON; diagramas relacionais usam Mermaid ou declarações nativas. Primeiro consulte Regras Gerais de Configuração, Estilo, Links e Diagnóstico e, em seguida, o tipo de gráfico correspondente; KChart não copia a aparência do Mermaid. Preencha apenas dados, semântica e intenção de leitura, não escreva coordenadas, tamanhos de fonte, cores ou scripts de desenho. Gráficos podem ter rolagem interna; a página em si não deve transbordar horizontalmente.

Pergunta do LeitorTipo de GráficoLeitura Sob Demanda
Como muda, quando muda?line, area, sparkline, small-multiples, stream, combo, bump, candlestick, launch-fanTendências
Qual é maior, quanto falta, quão longe da meta?bar, column, dumbbell, slope, bullet, gauge, interval, split-compareComparação
Como o todo é composto, quanto se perde em cada etapa?share, pie, donut, radial-share, rose, funnel, waterfall, waffle, tally, treemap, sunburstComposição
Como os valores se distribuem, há outliers ou correlação?histogram, boxplot, violin, strip, scatterDistribuição
Onde há anomalias em matrizes multidimensionais ou calendários?heatmap, bubble-matrix, calendar, radar, parallelMatriz
Quem está conectado a quem, como o volume flui?network, sankey, threadsRede
Onde estão distribuídos?choropleth, geo-scatterMapas
Como classificar, como expandir a partir de um tópico?KChart tree, mindmap; Mermaid mindmap, ishikawa, treeView-betaHierarquia e Mapas Mentais
Fluxo de quem para quem, como o estado transita?flowchart, stateDiagram-v2, journey, swimlane-beta, eventmodeling, agentflow-beta, nativo swimlaneFluxo
Qual é a ordem de chamada e quem são os participantes?sequenceDiagram, usecase-betaSequência
Como agendar, dividir em colunas ou numerar?gantt, timeline, gitGraph, kanban, packet, quadrantChartTempo e Grade
Como entidades, classes ou requisitos se relacionam?erDiagram, classDiagram, requirementDiagramModelo de Dados
Como uma regra de sintaxe corresponde a símbolos?railroad-beta, railroad-ebnf-beta, railroad-abnf-beta, railroad-peg-betaModelo de Dados
Como o sistema é estratificado, onde estão contêineres e dependências?C4Context, C4Container, C4Component, C4Dynamic, C4Deployment, architecture-beta, block, wardley-beta, nativo layers, blocksArquitetura
Visão geral de uma página: cartões em grupos, fluxo principal e legenda?Nativo blocks (cartões, emblemas, legendas, linhas de destaque); block se já houver diagrama de blocos MermaidArquitetura
Já tem gráficos de valor Mermaid?pie, xychart, sankey, radar-beta, treemapGráficos de Valor Mermaid; para novos gráficos de dados, use os tipos KChart acima
Como os conjuntos se sobrepõem, como os cenários são categorizados?venn-beta, cynefin-betaConjuntos, Cenários
Diagrama de chamada usando sintaxe ZenUML?zenuml (Renderização nativa KChart, sem plugins externos)ZenUML
Só quer confirmar a versão do renderizador?Mermaid info (não para entrega)Regras Gerais Mermaid

Em Markdown, use cercas kchart, mermaid, layers, blocks, swimlane; em HTML escrito à mão, use <pre data-viz="syntax">, escapando caracteres especiais HTML. Os títulos das figuras em documentos são escritos na declaração: KChart title, no preâmbulo do diagrama estrutural title: ou na instrução de título suportada pela sintaxe. Os títulos das figuras e o texto dentro delas devem estar no mesmo idioma do corpo. Quando as famílias de gráficos internas não conseguem acomodar ou expressar, como aninhamento muito profundo, muitas relações ou diagramas de mecanismo, primeiro divida em um diagrama geral e sub-diagramas; se ainda precisar desenhar manualmente, leia SVG Personalizado.

Referência Rápida de Comandos

O que fazerComando
Esboçar documento / gerar a partir da fontehtmlview doc new plan.html --type plan --title 'Plano de Avaliação de Capacidade' ou htmlview doc build spec.md --out spec.html --type tech-spec
Pacote de dados e relatóriohtmlview data init example → htmlview data validate example/report.json → htmlview data build example/report.json --out report.html
Esqueleto de protótipo de interfacehtmlview ui new prototype.html --title 'Processamento de Solicitação' --device mobile --screens 'Lista,Detalhes'
Auditoria estática, comparar conteúdohtmlview audit file.html; htmlview diff old.html new.html
Recarregar módulos de gráfico para documento ou protótipohtmlview style file.html (mantém tema e conteúdo existentes)
Verificação de exibição, captura de tela, exportaçãohtmlview check file.html; htmlview shot file.html --select 'figure'; htmlview export file.html --format pdf; captura de página inteira htmlview export file.html --format png
Ler corpo, incorporar recursos locaishtmlview read file.html [--outline ou --section id]; htmlview embed file.html
Gráfico independente, restrições de campo, paleta de cores, medida de texto em gráfico manualhtmlview viz render spec.json --out chart.svg; htmlview viz schema bar; htmlview viz palette --theme paper; htmlview viz measure 'Serviço de Pedidos' --size 13

Quando o usuário fornecer seu próprio esquema de cores, use --theme-file <JSON>, campos e exemplos em Arquivo de Tema. O tema é embutido no HTML; protótipos de interface usam esquemas de cores de marca independentes.

htmlview <subcomando> --help fornece parâmetros precisos. Para comandos de verificação, pass:false significa que a verificação foi concluída, mas problemas foram encontrados; corrija conforme failures[].fix. ok:false significa que o comando não pôde ser concluído; siga o tratamento error.next.

Validar Antes de Entregar

  1. Após criar ou modificar um artefato, execute audit. Se faltarem módulos de gráfico, execute style para reestruturar e, em seguida, audite novamente; se o relatório tiver evidências inconsistentes, volte ao pacote de dados para corrigir.
  2. Para alterações que afetam a exibição, execute check e, em seguida, shot para abrir a captura de tela real. Verifique a hierarquia de cabeçalhos, atribuição de texto, espaçamento em branco e a primeira tela em dispositivos móveis; para gráficos largos, abra o SVG completo para inspeção. Para protótipos interativos, percorra manualmente os caminhos críticos.
  3. Ao entregar em PDF, abra o PDF real e verifique se os títulos e os gráficos estão na mesma página e se as bordas estão intactas. Se encontrar avisos de impressão, troque para um tamanho de papel adequado ou ajuste o layout, mantendo um tamanho de fonte legível; se não for possível imprimir completamente, documente as limitações.

Habilidades Relacionadas