
Narrative Text Visualization
Turn datasets into T8 narrative reports with semantic annotations and inline mini charts for insight-led articles.
Overview
Narrative Text Visualization is an agent skill most often used in Build (also Grow, Launch) that generates T8-syntax data narratives with semantic annotations and embedded mini charts.
Install
npx skills add https://github.com/antvis/chart-visualization-skills --skill narrative-text-visualizationWhat is this skill?
- T8 Syntax workflow for data interpretation reports and summaries
- Declarative Markdown-like narratives with semantic entity annotations
- Built-in mini charts (pie, line) inside narrative text
- Framework-agnostic delivery for React, Vue, or vanilla JavaScript
- Lightweight AntV stack positioning under 20KB before gzip
- Lightweight bundle under 20KB before gzip
- Built-in mini charts include pie and line
Adoption & trust: 978 installs on skills.sh; 337 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have analysis results but stakeholders only see raw tables or disjoint charts—not a readable story that carries insight.
Who is it for?
Builders shipping analytics explainers, AI-generated reports, or AntV-backed narrative UIs who want declarative text-plus-chart output.
Skip if: Heavy bespoke D3 engineering, real-time ops dashboards, or teams that only need static PNG exports with no narrative layer.
When should I use this skill?
When users want data interpretation reports, summaries, or structured articles with semantic entity annotations via T8 Syntax.
What do I get? / Deliverables
You produce T8 narrative markup ready to render as a polished, annotated report with inline visualizations in your chosen JS framework.
- T8 narrative source document
- Structured report with entity annotations
- Render-ready narrative visualization spec
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Primary shelf is Build because output is structured visualization syntax and UI-ready narratives, not campaign distribution. Frontend fits declarative T8 markup consumed by React, Vue, or vanilla JS narrative components.
Where it fits
Generate T8 markup for a product metrics recap embedded in your SaaS UI.
Publish a monthly insights article with inline pie and line mini charts.
Ship a long-tail data explainer page designed for citations in AI search answers.
Draft a narrative summary of early user research metrics before committing to a dashboard build.
How it compares
Use for declarative insight narratives instead of manually stitching chart widgets into long-form copy.
Common Questions / FAQ
Who is narrative-text-visualization for?
Solo builders and data-facing product people who need structured, annotated data stories—not just single charts.
When should I use narrative-text-visualization?
In Build for frontend narrative components, in Grow when publishing analytics content, and at Launch when you need citable data explainers for SEO or AI search.
Is narrative-text-visualization safe to install?
Confirm upstream trust via the Security Audits panel on this page; generated narratives may summarize sensitive data you provide to the agent.
SKILL.md
READMESKILL.md - Narrative Text Visualization
# Narrative Text Visualization Skill This skill provides a workflow for transforming data into structured narrative text visualizations using **T8 Syntax** - a declarative Markdown-like language for creating data narratives with semantic entity annotations. ## What is T8 T8 is a text visualization solution under the AntV technology stack designed specifically for insight-based narrative text display. Instead of manually constructing DOM elements, you write simple, human-readable syntax that describes your data narrative. **Key Features:** - **LLM-Friendly**: The syntax is intuitive and can be easily generated by AI models - **Declarative & Readable**: Write what you want, not how to build it - **Framework Agnostic**: Works with React, Vue, or vanilla JavaScript - **Standardized Styling**: Professional appearance by default - **Built-in Data Visualizations**: Mini charts (pie, line) are native to the syntax - **Lightweight**: Less than 20KB before gzip ## Workflow To generate narrative text visualizations, follow these steps: ### 1. Understand the Requirements Analyze the user's request to determine: - The topic or data to be analyzed - The type of narrative needed (report, summary, article) - The key insights to highlight - Any specific data sources or metrics ### 2. Generate T8 Syntax Content Create narrative text using T8 Syntax following the specification below. The content must include: - Proper document structure (headings, paragraphs, lists) - Entity annotations for all meaningful data points - Appropriate metadata for entities (origin, assessment, etc.) ### 3. Generate Frontend Code Create HTML, React, or Vue code to render the T8 content based on user's preferred framework. ### 4. Validate Output Ensure: - All data is from authentic sources - Minimum content length (800 words or equivalent) - Proper entity annotations throughout - Clear structure and logical flow --- ## T8 Syntax Specification T8 Syntax is a Markdown-like language for creating narrative text with semantic entity annotations. It makes data analysis reports more expressive and visually appealing. ### Document Structure #### Headings (6 levels) Use standard Markdown heading syntax: ``` # Level 1 Heading (Main Title) ## Level 2 Heading (Section) ### Level 3 Heading (Subsection) #### Level 4 Heading ##### Level 5 Heading ###### Level 6 Heading ``` **Rules:** - Each heading must be on its own line - Add one space after the `#` symbols - Headings create visual hierarchy in the rendered output #### Paragraphs Regular text paragraphs are separated by blank lines: ``` This is the first paragraph with some content. This is the second paragraph, separated by a blank line. ``` **Rules:** - Paragraphs can span multiple lines - Use blank lines to separate distinct paragraphs - Text within a paragraph flows naturally #### Lists T8 Syntax supports both unordered and ordered lists. **Unordered Lists:** ``` - First item - Second item - Third item ``` **Ordered Lists:** ``` 1. First step 2. Second step 3. Third step ``` **Rules:** - Each list item must be on its own line - Add one space after the bullet marker (`-`, `*`) or number - Lists can contain entities and text formatting ### Text Formatting T8 Syntax supports inline text formatting using Markdown syntax: **Bold Text:** `This is **bold text** that stands out.` **Italic Text:** `This is *italic text* for emphasis.` **Underline Text:** `This is __underlined text__ for importance.` **Links:** `Visit [our website](https://example.com) for more information.` **Rules:** - For