html-view

Générer, inspecter et exporter des documents HTML hors ligne, des rapports de données et des maquettes d'interface, ainsi que dessiner des diagrammes SVG de données et de structure.

Qu'est-ce que html-view ?

La compétence **html-view** permet à un agent IA de générer, inspecter, exporter et styliser des documents HTML autonomes (hors ligne) ainsi que des graphiques SVG. Elle est particulièrement utile pour produire des rapports, des propositions techniques, des comptes rendus, des tableaux de bord, des maquettes interactives ou des diagrammes de données et de structure. Le cœur de la compétence repose sur un script CLI `htmlview` (Node.js 22+) qui orchestre la construction de documents à partir de Markdown, la validation et la compilation de paquets de données, la création de maquettes d'interface, le rendu de graphiques (KChart, Mermaid, diagrammes natifs), ainsi que des opérations de vérification, de capture d'écran et d'export (PDF/PNG). Elle supporte plusieurs plateformes (Claude Code, Cursor, Codex) et organise le travail par type de résultat : document, rapport de données, maquette UI, graphique isolé. Le processus est guidé par des références détaillées (flux de travail, composants, guides de conception) et impose des règles strictes : ne jamais modifier directement le HTML final pour les rapports de données, ne jamais inventer de données, et toujours valider avant livraison (audit, check, capture). L'utilisateur peut également changer le thème visuel d'un document HTML existant, ou comparer deux versions.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

HTML View

node <skill-dir>/scripts/htmlview est le point d'entrée en ligne de commande multi-plateforme ; ci-après abrégé en htmlview. Nécessite Node.js 22+ ; la vérification du navigateur, la capture d'écran, l'exportation et le rendu de graphiques isolés nécessitent également Chrome ou Chromium. Si aucun navigateur n'est trouvé, suivre error.next.

HTML existant : changement de thème uniquement

  • Artéfacts htmlview : documents, rapports ou pages de graphiques isolés : utiliser htmlview style file.html --theme cloudmusic (consulter les thèmes avec htmlview style --list) ; pour les maquettes d'interface : utiliser --scheme ou --brand. style met à jour le fichier sur place, ne réorganise que l'enveloppe et les graphiques dérivés. Pour obtenir un nouveau fichier, copier d'abord dans le même répertoire vers un nom de fichier non utilisé, exécuter style sur la copie, puis utiliser htmlview diff pour comparer le contenu.
  • HTML classique : style n'accepte pas le HTML classique. Lorsqu'il est nécessaire d'utiliser l'enveloppe de la compétence, créer un nouveau document thématique (voir flux document et composants document), déplacer le contenu existant dans le nouveau fichier ; ne pas réutiliser le CSS et les scripts de l'ancienne enveloppe. En cas de simple changement de style, conserver les chiffres, la granularité temporelle et les conclusions d'origine ; ne pas recalculer les données, ni supprimer les détails des graphiques originaux pour passer la vérification d'affichage.

Choix de l'entrée selon la tâche

Résultat attendu par l'utilisateurProcédureQuand développer
Proposition technique, rapport, notice, compte rendu ou fiche lisible et annotableAvec Markdown : doc build ; édition directe HTML : doc newLire d'abord flux document ; en cas d'écriture manuelle de composants HTML, d'ajout de références croisées ou de traitement de commentaires, lire composants document
Rapport ou tableau de bord nécessitant la vérification des chiffres, des définitions et des graphiquesCréer un paquet de données à partir du fichier de synthèse amont ; data validate puis data buildLire d'abord flux rapport ; pour modifier les champs, indicateurs, graphiques ou commentaires, lire paquet de données ; pour un tableau de bord, lire conception de tableau de bord
Maquette filaire, haute-fidélité ou prototype montrant un écran, un état ou un flux d'interactionui new puis renseigner chaque écran avec des composants réels et leurs valeursLire d'abord flux maquette UI ; pour choisir des composants ou écrire des interactions, lire index des composants ; pour la mise en page, les couleurs ou l'écriture de composants personnalisés, lire conception UI ; pour dessiner un tableau de bord, lire conception de tableau de bord
Graphique SVG unique ou page de graphique hors ligneChoisir une famille de graphiques dans le tableau ci-dessous, écrire la déclaration, puis viz renderPour les graphiques de données, lire d'abord règles générales de déclaration, puis la famille choisie ; pour les diagrammes de structure, lire directement la famille correspondante
Lire, vérifier, capturer ou exporter un HTML localUtiliser read, check, shot, export ou embedVoir Affichage et export pour les paramètres et les résultats de vérification
  • Lorsque le matériau n'est pas une structure de page prête (notes éparses, comptes rendus, JSON, CSV, logs, ou Markdown à réorganiser), lire Du matériau à la page avant d'écrire le contenu.
  • Les artéfacts HTML sont des fichiers uniques ouvrables hors ligne. Lors de l'écriture manuelle, ne modifier que le titre et le contenu entre <!-- htmlview:content --> et <!-- /htmlview:content --> ; ne conserver qu'une occurrence de chaque marqueur. La mise en page, le thème et les scripts d'exécution sont assemblés par la CLI.
  • Les documents construits à partir de Markdown doivent être modifiés en Markdown ; les rapports de données via le paquet de données, sans modifier directement le texte, les graphiques ou les chiffres générés. Ne pas inventer de données sans source ; les données de démonstration doivent être clairement indiquées comme des exemples fictifs.
  • Pour écraser un artéfact isolé existant, confirmer la cible avant d'utiliser --force ; la mise à jour d'un document de même source ne nécessite pas --force.
  • Sans --lang, les commandes de génération déterminent la langue des éléments d'enveloppe (numérotation des figures, table des matières, légendes, etc.) en fonction du titre et du corps : si le nombre de mots anglais est au moins le double du nombre de caractères chinois/japonais, l'anglais est utilisé ; sinon, le chinois. Pour d'autres langues ou un contenu moitié anglais moitié chinois, passer explicitement --lang.

Choix du graphique selon ce que le lecteur veut voir

Utiliser par défaut des graphiques statiques. Pour les graphiques de données, utiliser le format JSON KChart ; pour les diagrammes de structure, utiliser Mermaid ou une déclaration native. Consulter d'abord Règles générales de configuration, style, liens et diagnostic, puis le type de graphique correspondant ; KChart ne copie pas l'apparence de Mermaid. Ne remplir que les données, la sémantique et l'intention de lecture ; ne pas écrire de coordonnées, de tailles de police, de couleurs ou de scripts de dessin. Les graphiques peuvent défiler à l'intérieur si nécessaire, mais la page elle-même ne doit pas déborder horizontalement.

Question du lecteurType de graphiqueLecture selon les besoins
Comment ça évolue, quand ça change ?line, area, sparkline, small-multiples, stream, combo, bump, candlestick, launch-fanTendance
Lequel est plus grand, écart, distance à l'objectif ?bar, column, dumbbell, slope, bullet, gauge, interval, split-compareComparaison
De quoi est composé le total, pertes par étape ?share, pie, donut, radial-share, rose, funnel, waterfall, waffle, tally, treemap, sunburstComposition
Distribution des valeurs, valeurs aberrantes, corrélations ?histogram, boxplot, violin, strip, scatterDistribution
Anomalies dans une matrice multi-dimensionnelle ou un calendrier ?heatmap, bubble-matrix, calendar, radar, parallelMatrice
Qui est connecté à qui, flux de quantités ?network, sankey, threadsRéseau
Distribution géographique ?choropleth, geo-scatterCartes
Classification, déploiement à partir d'un thème ?KChart tree, mindmap ; Mermaid mindmap, ishikawa, treeView-betaHiérarchie et mindmap
Processus d'une entité à une autre, transition d'états ?flowchart, stateDiagram-v2, journey, swimlane-beta, eventmodeling, agentflow-beta, natif swimlaneProcessus
Ordre d'appels et participants ?sequenceDiagram, usecase-betaSéquence
Planification, colonnes, numérotation ?gantt, timeline, gitGraph, kanban, packet, quadrantChartTemps et grille
Relations entre entités, classes, exigences ?erDiagram, classDiagram, requirementDiagramModèle de données
Correspondance d'une règle de syntaxe avec des symboles ?railroad-beta, railroad-ebnf-beta, railroad-abnf-beta, railroad-peg-betaModèle de données
Architecture système, couches, conteneurs, dépendances ?C4Context, C4Container, C4Component, C4Dynamic, C4Deployment, architecture-beta, block, wardley-beta, natif layers, blocksArchitecture
Vue d'ensemble d'une page : cartes d'un groupe, processus principal, légende ?blocks natif (cartes, badges, légendes, lignes de mise en valeur) ; block si un diagramme en boîtes Mermaid existe déjàArchitecture
Graphiques de valeurs Mermaid existants ?pie, xychart, sankey, radar-beta, treemapGraphiques de valeurs Mermaid ; pour les nouveaux graphiques de données, utiliser les types KChart ci-dessus
Chevauchement d'ensembles, classification de situations ?venn-beta, cynefin-betaEnsembles, Situations
Diagramme d'appels avec la syntaxe ZenUML ?zenuml (rendu natif KChart, sans plugin externe)ZenUML
Vérification de version du moteur de rendu ?Mermaid info (pas pour livraison)Règles générales Mermaid

En Markdown, utiliser les blocs kchart, mermaid, layers, blocks, swimlane ; en HTML manuel, utiliser <pre data-viz="syntax">, en échappant les caractères HTML spéciaux. Les titres des figures sont écrits dans la déclaration : pour KChart : title, pour les diagrammes de structure : title: dans le préambule ou la déclaration de titre prise en charge par la syntaxe. Les titres des figures et le texte des figures sont dans la même langue que le corps du texte. En cas d'impossibilité de représentation avec les familles intégrées (imbrication trop profonde, relations trop nombreuses, schémas de mécanisme), diviser d'abord en vue d'ensemble et vues détaillées ; si un dessin manuel reste nécessaire, lire SVG personnalisé.

Aide-mémoire des commandes

ActionCommande
Brouillon de document / génération à partir d'une sourcehtmlview doc new plan.html --type plan --title 'Plan d'évaluation de capacité' ou htmlview doc build spec.md --out spec.html --type tech-spec
Paquet de données et rapporthtmlview data init example → htmlview data validate example/report.json → htmlview data build example/report.json --out report.html
Structure de maquette UIhtmlview ui new prototype.html --title 'Traitement des demandes' --device mobile --screens 'Liste,Détail'
Audit silencieux, comparaison de contenuhtmlview audit file.html ; htmlview diff old.html new.html
Réassemblage des modules de graphiques pour un document ou une maquettehtmlview style file.html (conserve le thème et le contenu existants)
Vérification d'affichage, capture d'écran, exporthtmlview check file.html ; htmlview shot file.html --select 'figure' ; htmlview export file.html --format pdf ; capture longue page htmlview export file.html --format png
Lecture du contenu, intégration de ressources localeshtmlview read file.html [--outline ou --section id] ; htmlview embed file.html
Graphique isolé, contraintes de champ, couleur de thème, mesure de texte de graphique manuelhtmlview viz render spec.json --out chart.svg ; htmlview viz schema bar ; htmlview viz palette --theme paper ; htmlview viz measure 'Service de commandes' --size 13

Lorsque l'utilisateur fournit sa propre palette de couleurs, utiliser --theme-file <JSON> ; les champs et exemples sont dans Fichier de thème. Le thème est intégré dans le HTML ; les maquettes d'interface utilisent une palette de couleurs de marque indépendante.

htmlview <sous-commande> --help donne les paramètres précis. Pour les commandes de vérification, pass:false signifie que la vérification est terminée mais que des problèmes ont été détectés ; les corriger selon failures[].fix. ok:false signifie que la commande n'a pas pu aboutir ; suivre error.next.

Validation avant livraison

  1. Après la création ou la modification d'un artéfact, exécuter audit. S'il manque des modules de graphiques, exécuter style pour réassembler, puis auditer à nouveau ; si le rapport présente des incohérences de preuves, corriger le paquet de données.
  2. Pour les modifications qui changent l'affichage, exécuter check, puis shot pour ouvrir la capture d'écran réelle. Vérifier la hiérarchie des titres, l'appartenance du texte, l'espacement et le premier écran mobile ; pour les graphiques larges, ouvrir le SVG complet pour inspection. Pour les prototypes interactifs, cliquer sur les chemins critiques réels.
  3. Lors de la livraison en PDF, ouvrir le PDF réel pour vérifier que les titres des figures et les figures sont sur la même page et que les bords sont complets. En cas d'avis d'impression, choisir un format de papier approprié ou ajuster la mise en page, en conservant une taille de police lisible ; si l'impression complète est impossible, expliquer la limitation.

Skills associés