CommunityProgramación y desarrollogithub.com

html-view

Genera, inspecciona y exporta documentos HTML autónomos, informes de datos y prototipos de interfaz, y dibuja gráficos SVG y diagramas estructurales.

¿Qué es html-view?

Esta habilidad permite a un agente de IA generar, revisar y exportar documentos HTML autónomos que pueden visualizarse sin conexión. Está diseñada para desarrolladores y creadores de contenido que necesitan entregar informes técnicos, paneles de control, prototipos de interfaz, diagramas SVG o informes de datos en formato HTML. La habilidad se basa en Node.js 22+ y requiere Chrome o Chromium para funciones avanzadas como capturas de pantalla, exportación a PDF/PNG y renderizado de gráficos. Proporciona un conjunto completo de comandos CLI (agrupados bajo `htmlview`) para crear documentos desde Markdown o HTML, construir paquetes de datos validados, diseñar prototipos de interfaz, generar gráficos de datos (usando KChart) y diagramas estructurales (usando Mermaid), aplicar temas visuales, auditar el contenido, comparar versiones y exportar el resultado final. También incluye guías detalladas para manejar temas, componentes de documentos, paquetes de datos, diseño de paneles y gráficos personalizados SVG. El flujo de trabajo típico implica elegir la tarea (documento, informe, prototipo, gráfico o revisión), seguir los pasos de la documentación de referencia, construir o modificar el contenido, y finalmente verificar y exportar el resultado. La habilidad también maneja la inferencia de idioma (inglés vs. chino) para elementos como títulos de gráficos y leyendas, basándose en la proporción de palabras en inglés y caracteres CJK en el contenido.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

HTML View

node <skill-dir>/scripts/htmlview es el punto de entrada del comando multiplataforma; a continuación, se usará la abreviatura htmlview. Requiere Node.js 22+. La verificación del navegador, la captura de pantalla, la exportación y el renderizado independiente de gráficos también necesitan Chrome o Chromium. Si no se encuentra el navegador, se maneja según error.next.

HTML existente: Solo cambiar tema

  • Artefactos de htmlview: Para documentos, informes o páginas de gráficos individuales, usa htmlview style file.html --theme cloudmusic (consulta htmlview style --list para ver los temas); para prototipos de interfaz, usa --scheme o --brand. style actualiza el lugar, solo reorganiza la carcasa y los gráficos derivados. Para generar un archivo nuevo, primero copia el archivo a un nombre no utilizado en el mismo directorio, ejecuta style en la copia y luego usa htmlview diff para comparar el contenido.
  • HTML normal: style no acepta HTML normal. Si es necesario usar la carcasa de la habilidad, crea un documento de tema nuevo (consulta Flujo de documentos y Componentes de documentos), migra el contenido existente al nuevo archivo; no reutilices el CSS ni los scripts de la carcasa anterior. Al solo cambiar el estilo, conserva los números, la granularidad de tiempo y las conclusiones originales; no recalculas los datos ni elimines detalles de la imagen original para pasar la verificación visual.

Seleccionar entrada según la tarea

Lo que el usuario quiereQué hacerCuándo expandir
Propuesta técnica, informe, explicación, acta o resumen de una página fácil de leer y anotarSi hay Markdown, usa doc build; si editas HTML directamente, usa doc newPrimero lee Flujo de documentos; al escribir componentes HTML a mano, agregar referencias cruzadas o procesar comentarios, lee Componentes de documentos
Informe o Dashboard para verificar cifras de negocio, métricas y gráficosCrea un paquete de datos a partir del archivo de resumen ascendente; después de data validate, ejecuta data buildPrimero lee Flujo de informes; al modificar campos, métricas, gráficos o narrativa, lee Paquete de datos; al hacer Dashboard, lee Diseño de panel
Esquemas, maquetas de alta fidelidad o prototipos que muestren pantallas, estados o flujos de interacciónDespués de ui new, completa cada pantalla y usa valores reales de los controlesPrimero lee Flujo de prototipos de interfaz; al seleccionar componentes o escribir interacciones, lee Índice de componentes; al definir diseños, colores o escribir componentes a mano, lee Diseño de interfaz; al dibujar paneles de datos, lee Diseño de panel
Gráfico SVG único o página de gráficos sin conexiónSelecciona la familia de gráficos en la tabla siguiente, escribe la declaración y luego viz renderPara gráficos de datos, primero lee Reglas generales de declaración; luego lee la familia de gráficos seleccionada; para diagramas estructurales, lee directamente la familia de gráficos correspondiente
Leer, inspeccionar, capturar o exportar HTML localUsa read, check, shot, export o embedLos parámetros y los resultados de la verificación se encuentran en Visualización y exportación
  • Cuando el material no es una estructura de página predefinida, como notas sueltas, actas de reuniones, JSON, CSV, registros o Markdown que necesita reorganización, antes de escribir el contenido, lee Del material a la página.
  • Los artefactos HTML son archivos individuales que se pueden abrir sin conexión. Al escribirlos a mano, solo modifica el título y el contenido entre <!-- htmlview:content --> y <!-- /htmlview:content -->; cada marcador se conserva una vez. El diseño, el tema y los scripts de ejecución los ensambla la CLI.
  • Los documentos construidos con Markdown modifican la fuente Markdown; los informes de datos modifican el paquete de datos, no el texto, gráficos o números generados directamente. No se pueden inventar datos sin fuente; los datos de demostración deben indicarse como ejemplos ficticios.
  • Para sobrescribir artefactos independientes existentes, confirma el objetivo antes de usar --force; la actualización de documentos de la misma fuente no necesita --force.
  • Cuando no se pasa --lang, el comando de generación infiere el idioma de las expresiones del shell (títulos de figuras, índices, leyendas, etc.) a partir del título y el cuerpo: se usa inglés si la cantidad de palabras en inglés es al menos el doble de la cantidad de caracteres CJK; de lo contrario, se usa chino. Para otros idiomas o contenido mitad inglés y mitad chino, pasa explícitamente --lang.

Seleccionar gráfico según lo que el lector quiere ver

Por defecto se usan gráficos estáticos. Los gráficos de datos usan KChart JSON; los diagramas estructurales usan Mermaid o declaraciones nativas. Primero consulta las reglas generales de configuración, estilo, enlaces y diagnóstico; luego consulta el tipo de gráfico correspondiente. KChart no copia la apariencia de Mermaid. Solo completa los datos, la semántica y la intención de lectura; no escribas coordenadas, tamaños de fuente, colores ni scripts de dibujo. Los gráficos pueden tener desplazamiento interno si no caben; la página en sí no debe desbordarse horizontalmente.

Pregunta del lectorEntrada del tipo de gráficoLectura según necesidad
¿Cómo cambia? ¿Cuándo cambia?line, area, sparkline, small-multiples, stream, combo, bump, candlestick, launch-fanTendencia
¿Cuál es más grande? ¿Cuánta diferencia hay? ¿Qué tan lejos del objetivo?bar, column, dumbbell, slope, bullet, gauge, interval, split-compareComparación
¿Cómo se compone el total? ¿Cuánto se pierde en cada paso?share, pie, donut, radial-share, rose, funnel, waterfall, waffle, tally, treemap, sunburstComposición
¿Cómo se distribuyen los valores? ¿Hay valores atípicos o correlaciones?histogram, boxplot, violin, strip, scatterDistribución
¿Dónde hay anomalías en una matriz multidimensional o un calendario?heatmap, bubble-matrix, calendar, radar, parallelMatriz
¿Quién se conecta con quién? ¿Cómo fluye la cantidad?network, sankey, threadsRed
¿Dónde se distribuye?choropleth, geo-scatterMapas
¿Cómo se clasifica? ¿Cómo se expande desde un tema?KChart tree, mindmap; Mermaid mindmap, ishikawa, treeView-betaJerarquía y mapa mental
¿Cómo fluye el proceso de quién a quién? ¿Cómo se transfieren los estados?flowchart, stateDiagram-v2, journey, swimlane-beta, eventmodeling, agentflow-beta, nativo swimlaneFlujo
¿Quiénes son las llamadas secuenciales y los participantes?sequenceDiagram, usecase-betaSecuencia
¿Cómo programar, dividir en columnas o numerar?gantt, timeline, gitGraph, kanban, packet, quadrantChartTiempo y cuadrícula
¿Cómo se relacionan entidades, clases o requisitos?erDiagram, classDiagram, requirementDiagramModelo de datos
¿Cómo coincide una regla gramatical con los símbolos?railroad-beta, railroad-ebnf-beta, railroad-abnf-beta, railroad-peg-betaModelo de datos
¿Cómo se divide el sistema en capas, contenedores y dependencias?C4Context, C4Container, C4Component, C4Dynamic, C4Deployment, architecture-beta, block, wardley-beta, nativo layers, blocksArquitectura
¿Resumen de una página: tarjetas en grupos, flujo principal y leyendas?Nativo blocks (tarjetas, insignias, leyendas, líneas de énfasis); si ya hay un diagrama de bloques de Mermaid, blockArquitectura
¿Ya tienes un gráfico numérico de Mermaid?pie, xychart, sankey, radar-beta, treemapGráficos numéricos de Mermaid; para nuevos gráficos de datos, usa los tipos KChart anteriores
¿Cómo se superponen los conjuntos? ¿Cómo se clasifican los escenarios?venn-beta, cynefin-betaConjuntos, Escenarios
¿Diagrama de llamadas usando sintaxis ZenUML?zenuml (renderizado nativo por KChart, sin complementos externos)ZenUML
¿Solo quieres confirmar la versión del renderizador?Mermaid info (no para entrega)Reglas generales de Mermaid

Markdown usa vallas kchart, mermaid, layers, blocks, swimlane; HTML escrito a mano usa <pre data-viz="sintaxis">, escapando los caracteres HTML especiales. Los títulos de las figuras se escriben en la declaración: KChart title, prefacio del diagrama estructural title: o la declaración de título compatible con esa sintaxis. Los títulos de las figuras y el texto dentro de las figuras usan el mismo idioma que el cuerpo. Cuando la familia de figuras incorporada no es suficiente o no se puede expresar, como anidamiento demasiado profundo, demasiadas relaciones o ilustración de mecanismos, primero divide en una figura general y figuras secundarias; si aún es necesario dibujar a mano, consulta SVG personalizado.

Referencia rápida de comandos

Qué hacerComando
Redactar documento / Generar desde fuentehtmlview doc new plan.html --type plan --title 'Plan de evaluación de capacidad' o htmlview doc build spec.md --out spec.html --type tech-spec
Paquete de datos e informehtmlview data init example → htmlview data validate example/report.json → htmlview data build example/report.json --out report.html
Esqueleto de prototipo de interfazhtmlview ui new prototype.html --title 'Procesamiento de solicitud' --device mobile --screens 'Lista, Detalle'
Auditoría silenciosa, comparación de contenidohtmlview audit file.html; htmlview diff old.html new.html
Recargar módulos de figuras para documento o prototipohtmlview style file.html (conserva el tema y el contenido existentes)
Verificación visual, captura de pantalla, exportaciónhtmlview check file.html; htmlview shot file.html --select 'figure'; htmlview export file.html --format pdf; imagen de página completa htmlview export file.html --format png
Leer cuerpo, incrustar recursos localeshtmlview read file.html [--outline o --section id]; htmlview embed file.html
Figura independiente, restricciones de campo, color del tema, medir cantidad de texto de figura hecha a manohtmlview viz render spec.json --out chart.svg; htmlview viz schema bar; htmlview viz palette --theme paper; htmlview viz measure 'Servicio de pedidos' --size 13

Cuando el usuario proporciona su propia paleta, usa --theme-file <JSON>; los campos y ejemplos se encuentran en Archivo de tema. El tema está incrustado en el HTML; los prototipos de interfaz usan colores de marca independientes.

htmlview <subcomando> --help proporciona parámetros precisos. pass:false en comandos de verificación significa que la verificación se completó pero se encontraron problemas; repara según failures[].fix. ok:false significa que el comando no pudo completarse; maneja según error.next.

Verificar antes de entregar

  1. Después de crear o modificar un artefacto, ejecuta audit. Si faltan módulos de figuras, ejecuta style para reorganizar y luego auditar; si el informe tiene inconsistencias en la evidencia, corrige el paquete de datos.
  2. Para cambios que afecten la visualización, ejecuta check y luego shot para abrir la captura de pantalla real. Revisa los niveles de títulos, la pertenencia del texto, los espacios en blanco y la primera pantalla en dispositivos móviles; para figuras anchas, abre el SVG completo para inspeccionar. Para prototipos interactivos, recorre los caminos críticos manualmente.
  3. Al entregar PDF, abre el PDF real y verifica que el título de la figura y la figura estén en la misma página y que los bordes estén completos. Si aparecen indicaciones de impresión, cambia al tamaño de papel adecuado o ajusta el diseño, manteniendo un tamaño de fuente legible; si no se puede imprimir correctamente, explica la limitación.

Skills relacionados