К основному содержанию
скилл CX Codex

tufte-report — скилл для Claude Code: что делает и как установить

Скилл tufte-report собирает HTML-отчёты с интерактивными графиками и таблицами в стиле Эдварда Тафти — высокая плотность данных, минимум украшений, двухколоночная вёрстка с боковыми врезками.

MIT 202 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill tufte-report -a claude-code
Открыть на GitHub

Что делает tufte-report

Скилл создаёт автономные HTML-файлы: шрифты EB Garamond для текста и Monaspace Argon для цифр, графики на Chart.js, встроенные SVG-спарклайны. Выходит документ с повествованием в левой колонке и данными в правой — как в журнале, где текст и графики делят одно пространство.

Скилл навязывает ограничения: максимум 8 разделов, 2 типа графиков на раздел, 3 цвета на график. Круговые, объёмные и пончиковые диаграммы запрещены. Каждый график требует подпись из одного предложения. Без подписи график не попадёт в отчёт.

Подходит для дашбордов активности, личной аналитики, визуализации здоровья, инфографики. Работает без сборки — один файл открывается в любом браузере.

Какие задачи решает

  • собрать отчёт с данными из CSV, JSON или SQLite
  • создать дашборд с KPI и спарклайнами
  • визуализировать трекер здоровья
  • построить инфографику в стиле Тафти
  • сверстать документ с таблицами и графиками в две колонки

Примеры запросов агенту

  • Собери отчёт по данным из metrics.csv в стиле Тафти
  • Создай дашборд активности с графиками шагов и пульса
  • Сделай инфографику по квартальным показателям из q4.json

Как установить tufte-report

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill tufte-report -a claude-code

2Вручную: положить файлы

~/.claude/skills/tufte-report/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tufte-report/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tufte-report

Как установить tufte-report в Claude Code?

Выполни npx skills add glebis/claude-skills --skill tufte-report -a claude-code, затем скилл появится в ~/.claude/skills/tufte-report/SKILL.md.

Что делает tufte-report?

Скилл создаёт HTML-отчёты с графиками и таблицами в стиле Эдварда Тафти: двухколоночная вёрстка, боковые врезки, высокая плотность данных. Использует EB Garamond, Monaspace Argon, Chart.js и SVG-спарклайны.

Какие форматы данных принимает tufte-report?

Скилл работает с CSV, JSON, SQLite и API-эндпоинтами. Перед генерацией отчёта скилл спросит источник данных и главный вопрос, на который отчёт должен ответить.

Исходный текст

SKILL.md · MIT
---
name: tufte-report
description: Create Tufte-inspired data reports and infographic dashboards as standalone HTML files. Uses EB Garamond for text, Monaspace Argon for numbers, Chart.js for interactive charts, and inline SVG sparklines. Produces publication-quality reports with 2-column narrative+data layouts, status dashboards, scroll animations, and responsive mobile support. Use this skill whenever the user wants to create a data report, activity dashboard, infographic, personal analytics page, health tracker visualization, or any document that combines narrative text with interactive charts and tables. Also triggers for "make a report like Tufte", "create an infographic", "build a dashboard", "visualize my data", or requests for beautiful data-driven documents.
---

# Tufte Report — Data-Driven Infographic Skill

Create standalone HTML reports that combine editorial narrative with interactive data visualization in Edward Tufte's style: high information density, minimal chart junk, typography-first design.

## Design Philosophy

Tufte's core principles drive every decision:
- **Data-ink ratio**: every pixel of ink should represent data, not decoration
- **Small multiples**: repeat a design to show comparison, not animation
- **Sparklines**: word-sized graphics that live inside prose
- **Layering**: overview first, then detail on demand
- **Integration**: text and graphics share the same visual space (sidenotes, not footnotes)

The report should feel like a well-edited magazine feature — you read it top to bottom, narrative carries you through the data, and every chart earns its space by answering a specific question.

## Onboarding — Ask Before Building

Before writing ANY code, ask these questions. Do not proceed until all are answered:

1. **What data sources do you have?** (CSV, JSON, SQLite, API endpoint, or raw numbers)
2. **What is the primary question this report should answer?** (one sentence — this becomes the title and drives all design decisions)
3. **How many sections do you need?** (cap at 8 — push back if more are requested; each section should answer one sub-question)
4. **What's the output format?** (standalone HTML file, or embedded component)
5. **Time budget?** Provide an estimate:
   - 1-2 sections with tables only: ~200 LOC, ~5 min bypass / ~10 min manual
   - 3-4 sections with 2-3 charts: ~500 LOC, ~15 min bypass / ~25 min manual
   - 5-8 sections with charts + health data + sparklines: ~1200 LOC, ~30 min bypass / ~50 min manual

## Scope Protection

This skill enforces hard limits to prevent scope creep:

- **Max 8 sections** — if the user asks for more, suggest combining related topics
- **Max 2 chart types per section** — a section gets one primary chart and optionally one supporting chart or table. More than that means the section should split
- **Max 3 colors per chart** — beyond that, use small multiples instead of rainbow legends
- **No 3D charts, no pie charts, no donut charts** — these violate Tufte principles
- **No gratuitous animation** — scroll-reveal on enter is fine; spinning, bouncing, or pulsing is not
- **Every chart must have a caption** — if you can't write a one-sentence caption explaining what the chart shows, the chart shouldn't exist

When the user asks for something outside these limits, respond with: "That would take the report from [current LOC estimate] to [new estimate]. The extra complexity adds [X] but risks [Y]. Shall I proceed, or can we [simpler alternative]?"

## Architecture

```
report.html (standalone, no build step)
├── Google Fonts CDN (EB Garamond)
├── jsDelivr CDN (Monaspace Argon woff2)
├── jsDelivr CDN (Chart.js 4.x UMD)
├── Inline <style> (design system CSS)
├── Inline HTML (semantic structure)
└── Inline <script> (data + Chart.js configs + sparklines + scroll-reveal)
```

No build tools, no frameworks, no npm. One file, opens in any browser.

## Design System

Read `references/design-tokens.md` for the complete CSS variables, typography scale, and color palette.

Read `references/components.md` for the HTML+CSS snippet of every reusable component.

Read `references/charts.md` for Chart.js configuration patterns and inline SVG sparkline code.

## Report Structure Template

Every report follows this skeleton:

```
1. Title + subtitle + data source tags (monospace, subtle)
2. [Optional] Status dashboard (4-column KPI strip)
3. Overview narrative with inline sparklines + TOC sidebar
4. Summary cards (2-4 KPI tiles with sparklines)
5. Sections (each: state-line → chart+narrative aside → table+narrative aside)
6. [Optional] Decision register (threshold table with status colors)
7. Footer (generation date, sources)
```

### Section Pattern

Each section follows this rhythm:
```
<h2> with ↑ back-to-top link
<p class="state-line"> — one italic sentence, the takeaway
<div class="aside-container"> — chart on left, narrative on right
<div class="aside-container"> — table on left, interpretation on right
```

The alternation of chart→narrative→table→narrative creates visual breathing room and prevents "wall of data" fatigue.

### Rules for Narrative Text

- **State-lines** (the italic intro under each heading): one sentence, max 20 words, states the conclusion not the topic. "HRV down 13%, steps down 42%" not "This section covers health metrics"
- **Aside narratives**: 3-4 short paragraphs, each starting with a bold keyword. Written like a newspaper sidebar — facts first, interpretation second
- **Flyouts**: reserved for actionable insights or methodology notes. The ✦ symbol marks them as "pay attention"
- **No "tells its own story"** or similar filler. Every sentence should contain a number or a decision

## Dual-Font Strategy

| Context | Font | Why |
|---------|------|-----|
| All body text, headers, captions | EB Garamond | Classical editorial feel, excellent readability |
| All numbers in tables | Monaspace Argon | Tabular figures align in columns, monospace scannability |
| Big numbers in cards/dashboards | Monaspace Argon | Visual weight, distinct from prose |
| Status indicators, trend percentages | Monaspace Argon | Precision signaling |
| Data source tags, code references | Monaspace Argon | Technical register |
| Ornament separators (:::) | Monaspace Argon with ligatures | Programming aesthetic, replaces floral Unicode |

## Color Principles

Use `--ink` (near-black) for text, `--bg` (warm white) for background. Chart colors must be semantically meaningful — don't assign colors randomly:

- **Orange** (`--spark-claude`, #c45a28): primary data stream, effort/work metrics
- **Green** (`--spark-wispr`, #2a7a5a): growth, positive health signals, English language
- **Purple** (`--spark-social`, #5a5aaa): social/communication metrics
- **Blue** (rgba(42,80,140)): secondary overlay lines on charts
- **Red** (#a02a2a): alerts, negative trends, declining metrics
- **Amber** (#c89000): warnings, watch-level signals
- **Green** (#2a7a3a): healthy baselines, positive trends

Never use more than 3 colors in a single chart. If you need more, use opacity/saturation variations of the same hue.

## Session Lessons (What Goes Wrong)

Based on building the reference report, these are the recurring problems:

1. **Chart.js CDN version**: Use `@4` not a specific patch version — specific versions may not exist
2. **Chart.js defaults**: Set individual properties, never replace entire objects (`Chart.defaults.scale.grid.color = '#eee'` not `Chart.defaults.scale.grid = {color: '#eee'}`)
3. **Legend circles**: Use `usePointStyle: false` with `boxWidth: 8, boxHeight: 8, borderRadius: 4` for true circles. `usePointStyle: true` creates ovals
4. **file:// protocol**: Charts won't load CDN scripts via file://. Always test via localhost
5. **Back-to-back charts**: Always separate consecutive charts with narrative, a table, or an ornament. Two charts in a row = "wall of data"
6. **Table overflow on mobile**: Wrap in `.table-wrapper` and add `.hide-mobile` to secondary columns
7. **Dual-axis charts**: Use sparingly — they invite false visual equivalence. Always label both axes clearly
8. **Narrative overreach**: Don't claim correlations without computing them. "r = 0.10" is more trustworthy than "strong relationship"

## Universal Data Adapter

When the user provides data from any source (CSV, JSON, SQLite, API, raw numbers), normalize it into the standard **ReportData** intermediate format before generating HTML. This decouples data ingestion from report rendering.

Read `references/data-adapter.md` for the ReportData JSON schema, field reference, and adapter instructions for each source type.

**Workflow:**
1. User provides data → identify source type
2. Transform into ReportData JSON (ask user for `meta.question` and desired sections)
3. Confirm the normalized structure with the user
4. Generate HTML from the ReportData using the block library

## Composable Block Library

Reports are assembled from typed blocks, each with a defined data contract. This replaces ad-hoc HTML generation with a systematic approach.

Read `references/blocks.md` for the complete block catalog: sparkline-row, kpi-card, trend-chart, data-table, correlation-matrix, narrative, heatmap, strip-chart.

Each block defines:
- **Data contract** (what JSON shape it expects)
- **HTML template** (copy-paste ready)
- **Composition rules** (how blocks pair and sequence)

## Preview Server

For iterative development, use the built-in live-reload server:

```bash
python3 ~/.claude/skills/tufte-report/scripts/serve.py report.html
```

Serves on `localhost:8042`, auto-reloads on file change with scroll position preserved. Zero dependencies — Python stdlib only.

Read `references/preview-server.md` for details. After generating a report, offer to start the preview server for the user.

© glebis · MIT · glebis/claude-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
report-with-html daymade Скилл report-with-html для Claude Code создаёт автономные визуальные HTML-отчёты, интерактивные дашборды и верстаки для ревью. Запускается по прямому запросу на веб-отчёт или визуализацию данных. CX Codex +1 143установок storytelling-with-data sammcj Скилл storytelling-with-data для Claude Code помогает выстроить историю по данным и проверить визуализацию. Подключается, когда нужно сформулировать главный вывод для графика, дашборда или отчёта. CX Codex +1 ★ 173звёзд репо power-bi-report-design-consultation официальный github Скилл power-bi-report-design-consultation для GitHub Copilot проектирует Power BI-отчёт: выбирает визуализации, продумывает структуру страниц и учитывает аудиторию. Ведёт к конкретным решениям. CX Codex +1 9 390установок build-dashboard официальный anthropics Скилл build-dashboard для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который собирает интерактивный HTML-файл с графиками, фильтрами и таблицами. Открывается прямо в браузере без сервера и зависимостей. CX Codex +1 9 700установок pdf-report-generator datadrivenconstruction Скилл pdf-report-generator автоматизирует создание PDF-отчётов из данных строительных проектов. Собирает графики, таблицы и ключевые показатели в оформленный документ — без ручного монтажа. CX Codex +1 132установок build-report официальный Data Analytics Maintainers Скилл build-report для Codex и ChatGPT собирает аналитический отчёт, который живёт дольше, чем ответ в чате. Вместо дампа из блокнота вы получаете связный текст с выводами, таблицами и оговорками. CX Codex GP ChatGPT +1 4установок

Из того же набора51

Весь набор →
context-builder Скилл context-builder для Claude Code, Codex, Cursor и других платформ, который генерирует интерактивные промпты для сбора контекста у клиентов консалтинговых проектов по AI-трансформации. CX Codex +1 226установок wispr-analytics Скилл wispr-analytics подключается к локальной базе Wispr Flow для анализа истории голосовых заметок, проверки просодии речи и ведения словаря терминов. CX Codex +1 218установок nano-banana Скилл nano-banana для Claude Code создаёт и редактирует изображения через Gemini, применяет стили и размеры площадок. Создаёт обложки, слайды, изображения к статьям и серии вариантов. CX Codex +1 216установок gpt-image-2 Пошаговый генератор картинок через OpenAI GPT Image 2 API с готовыми стилями, режимом черновиков для экономии и проверкой промптов на ошибки. CX Codex +1 213установок temple-generator Скилл temple-generator превращает базу заметок Obsidian в трёхмерную интерактивную карту Three.js с кольцами сущностей, семантическим зумом и звуком. CX Codex +1 199установок meeting-processor Скилл meeting-processor разбирает транскрипты встреч из Fathom и Granola, определяет тип звонка и извлекает договорённости с контекстом переговоров. CX Codex +1 195установок session-search Скилл session-search для Claude Code ищет прошлые сессии по смыслу, ключевым словам и связанным понятиям. Находит старые отладки и исследования. CX Codex +1 192установок browsing-history Скилл browsing-history ищет посещённые страницы по времени, устройству, домену и словам в запросе. Результаты можно сгруппировать и сохранить в Markdown или JSON. CX Codex +1 188установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой