narrative-text-visualization

# Narrative Text Visualization Skill

This skill provides a workflow for transforming data into structured narrative text visualizations using the AntV T8 (Text) schema. T8 is designed for unstructured data visualization where `T` stands for Text, and `8` represents a byte of 8 bits, symbolizing deep insights hidden beneath the text.

## Overview

`T8` is a declarative JSON Schema syntax used to describe data interpretation reports with semantic entity labeling. It's designed to be:
- **LLM-friendly**: Easy to generate with AI prompts
- **Technology stack agnostic**: Works with React, Vue, and other frameworks
- **Extensible**: Supports custom entity phrases
- **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. Review the JSON Schema

Consult the `references/schema.json` file to understand the T8 structure:
- **Top Structure**: Contains `headline` and `sections` array
- **Sections**: Main chapters containing `paragraphs`
- **Paragraphs**: Text blocks containing `phrases`, can be:
  - `normal`: Regular text paragraphs
  - `heading1-6`: Heading levels
  - `bullets`: Bulleted/ordered lists
- **Phrases**: Text elements that can be:
  - `text`: Plain text
  - `entity`: Semantically labeled data with metadata

### 3. Entity Labeling

Use entity types to mark key information (see `references/prompt.md` for details):

| Entity Type          | Description             | Example                              |
| -------------------- | ----------------------- | ------------------------------------ |
| `metric_name`        | Indicator name          | "Shipment", "Growth Rate"            |
| `metric_value`       | Main indicator value    | "146 million units", "120 fa