timeline-builder — скилл для Claude Code: HTML-таймлайны
Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме.
MIT ★ 4 719 обновлён 2026-10-24
npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-codeЧто делает timeline-builder
Скилл создаёт статическую HTML-страницу из конфигурации JSON. Можно выбрать вертикальную раскладку, горизонтальную прокрутку или размещение событий по сторонам оси; подробности карточек раскрываются по клику. Цвета, значки и метки категорий задаются в конфигурации.
В комплекте скрипт scripts/generate_timeline.py: он принимает путь к JSON-файлу или данные из стандартного ввода и сохраняет результат в HTML либо выводит его в stdout. Параметр --layout переопределяет раскладку из файла, а --title — заголовок таймлайна. Для работы нужен Python 3.6 или новее; используются только стандартные библиотеки Python. Без Python скрипт не запустится.
Какие задачи решает
- показать этапы проекта в хронологическом порядке
- собрать историю выпусков продукта в HTML
- сравнить события, размещённые по разные стороны оси
- оформить резюме как интерактивную хронологию
Примеры запросов агенту
- Собери HTML-таймлайн из
timeline_data.jsonс вертикальной раскладкой. - Прочитай события из
timeline_data.jsonи создай горизонтальную хронологию вtimeline.html. - Покажи этапы проекта по сторонам оси, используя данные из
data.json.
Как установить timeline-builder
1Через Skills CLI (Vercel)
npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/timeline-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/timeline-builder/
1Через Skills CLI (Vercel)
npx skills add zebbern/claude-code-guide --skill timeline-builder -a codex2Вручную: положить файлы
.agents/skills/timeline-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add zebbern/claude-code-guide --skill timeline-builder -a cursor2Вручную: положить файлы
.cursor/skills/timeline-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install zebbern/claude-code-guide skills/timeline-builder2Вручную: положить файлы
.github/skills/timeline-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add zebbern/claude-code-guide --skill timeline-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/zebbern/claude-code-guide --path skills/timeline-builderВручную: положить файлы
.devin/skills/timeline-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о timeline-builder
Как установить timeline-builder в Claude Code?
Выполните npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-code. Файл скилла находится по пути ~/.claude/skills/timeline-builder/SKILL.md.
Что делает timeline-builder?
Он создаёт интерактивные HTML-таймлайны из данных JSON. Можно настроить раскладку и цвета, а подробности событий открывать по клику.
Какие раскладки поддерживает timeline-builder?
Вертикальную с карточками по обе стороны оси, горизонтальную с прокруткой и двустороннюю, где сторона задаётся для события.
Исходный текст
SKILL.md · MIT
---
name: timeline-builder
description: "Generate beautiful interactive timeline HTML pages from JSON data, with vertical, horizontal, or dual-side layouts, collapsible details, and custom colors. Ideal for project milestones, company histories, or resumes. Triggered when a user mentions 'timeline', 'history of events', 'project milestones', 'release log', or asks to visualize a chronological sequence of data."
license: MIT
type: tool
tags: ["timeline", "html", "visualization", "interactive", "responsive"]
---
# Timeline Builder
Generate beautiful interactive timeline HTML pages from JSON configuration data, with three layout modes:
1. **Vertical layout (`vertical`)** — A classic top-to-bottom timeline with event cards alternating on either side of the axis
2. **Horizontal layout (`horizontal`)** — A horizontally scrollable timeline, best for displaying fewer events
3. **Dual-side layout (`dual-side`)** — Events are placed on the left or right based on the `side` field, great for side-by-side comparisons
All layouts support:
- Click to expand/collapse event details
- Mobile-friendly responsive design
- Custom theme colors, icons, and category labels
- Pure static HTML with zero dependencies — opens directly in any browser
## Usage
### Basic: Generate from a JSON config file
```bash
python3 scripts/generate_timeline.py --config timeline_data.json --output timeline.html
```
### Read JSON from stdin
```bash
cat timeline_data.json | python3 scripts/generate_timeline.py --stdin --output timeline.html
```
### Override layout mode (takes precedence over config file)
```bash
python3 scripts/generate_timeline.py --config data.json --layout horizontal --output timeline.html
```
### JSON Configuration Format
```json
{
"title": "Project Milestones",
"layout": "vertical",
"theme": {
"primaryColor": "#2563eb",
"secondaryColor": "#7c3aed",
"backgroundColor": "#ffffff",
"textColor": "#1f2937",
"lineColor": "#d1d5db",
"fontFamily": "system-ui, -apple-system, sans-serif"
},
"events": [
{
"date": "2024-01-15",
"title": "Project Kickoff",
"summary": "Approval completed, core team assembled",
"details": "Detailed description text, shown when the card is expanded...",
"icon": "🚀",
"category": "Milestone",
"color": "#10b981",
"side": "left"
}
]
}
```
### CLI Arguments
| Argument | Description |
|----------|-------------|
| `--config, -c` | Path to the JSON config file (mutually exclusive with `--stdin`) |
| `--stdin` | Read JSON from standard input |
| `--output, -o` | Output HTML file path (defaults to stdout) |
| `--layout, -l` | Override layout mode: `vertical`, `horizontal`, `dual-side` |
| `--title, -t` | Override the timeline title |
### Event Fields
| Field | Required | Description |
|-------|----------|-------------|
| `date` | Yes | Date label — any format works (e.g. `2024-01`, `Q1 2024`, `Phase One`) |
| `title` | Yes | Event title |
| `summary` | No | Short description, always visible on the card |
| `details` | No | Detailed content, revealed on click |
| `icon` | No | Emoji or single-character icon (defaults to `●`) |
| `category` | No | Category tag displayed on the card |
| `color` | No | Event node color (overrides the theme color) |
| `side` | No | Only for dual-side layout: `left` or `right` |
## Use Cases
- Project milestone displays
- Product release histories
- Company growth timelines
- Personal resume timelines
- Course syllabus outlines
- Any scenario requiring chronological information display
## Dependencies
- Python 3.6+ (standard library only — no extra packages required)
© zebbern · MIT · zebbern/claude-code-guide