Skip to main content
skill CX Codex

timeline-builder — Claude Code skill for HTML timelines

timeline-builder is a Claude Code skill that turns JSON event data into interactive HTML timelines with vertical, horizontal, or dual-side layouts. It covers project milestones, release histories, and resumes.

MIT ★ 4,719 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-code
Open on GitHub

What timeline-builder does

The skill builds a static HTML page from a JSON configuration. Choose a vertical layout, a horizontally scrollable view, or a dual-side arrangement that places events according to their side field. Readers can expand event cards to see details; colors, icons, and category labels come from the configuration.

The included scripts/generate_timeline.py accepts a JSON file or standard input, then writes HTML to a file or stdout. Use --layout to replace the layout from the config, or --title to set a different heading. Python 3.6 or later is required, and the script uses Python’s standard library. It will not run without Python.

What it helps with

  • turn project milestones into a chronological page
  • publish a product release history as HTML
  • compare events placed on opposite sides of a timeline
  • present a resume as an interactive chronology

Example prompts for the agent

  • Build a vertical HTML timeline from timeline_data.json.
  • Create a horizontal timeline in timeline.html using events from timeline_data.json.
  • Arrange the project events on both sides of the axis using data.json.

How to install timeline-builder

1Skills CLI (Vercel)

npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-code

2Manually: put the files in place

~/.claude/skills/timeline-builder/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/timeline-builder/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about timeline-builder

How do I install timeline-builder in Claude Code?

Run npx skills add zebbern/claude-code-guide --skill timeline-builder -a claude-code. The skill file is at ~/.claude/skills/timeline-builder/SKILL.md.

What does timeline-builder do?

It generates interactive HTML timelines from JSON data. You can choose a layout and theme colors, and readers can open event details from the cards.

Which layouts can timeline-builder create?

It supports a vertical timeline, a horizontally scrollable timeline, and a dual-side view that uses each event’s side field.

Source text

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

Similar skills

All skills for Frontend and UI →

From the same set86

The whole set →
webgpu-renderer The webgpu-renderer rule guides Three.js WebGPU setup with a WebGL 2 fallback. Use it when a 3D scene needs compute work, GPU particles, or indirect rendering. CX Codex +1 ★ 4,719repo stars tsl-material-slots tsl-material-slots is a Claude Code rule with a reference to Three.js TSL material slots. It helps write node-based shader logic without mistyping slot names or property types. CX Codex +1 ★ 4,719repo stars core-web-vitals core-web-vitals is a Claude Code rule for loading Three.js models and textures without letting heavy 3D delay first paint or degrade LCP, FID and CLS. CX Codex +1 ★ 4,719repo stars postprocessing-optimization postprocessing-optimization is a rule for Three.js and React Three Fiber that helps optimize post-processing by combining shader passes and tuning render settings. CX Codex +1 ★ 4,719repo stars loading-suspense loading-suspense — a rule that keeps async React Three Fiber components inside Suspense, so a model still downloading doesn't leave the canvas blank. CX Codex +1 ★ 4,719repo stars lighting-shadows-advanced The lighting-shadows-advanced rule covers lighting and shadow settings in Three.js with rendering cost in mind. Use it when tuning a scene with several lights or shadow maps. CX Codex +1 ★ 4,719repo stars migration-checklist migration-checklist teaches the agent how to migrate code when Three.js updates. Lists breaking changes from r125 onwards and current import paths. CX Codex +1 ★ 4,719repo stars audio-spatial The audio-spatial rule for Claude Code provides Three.js 3D audio patterns for source positioning, distance falloff, and response to user interaction. CX Codex +1 ★ 4,719repo stars

Project sponsors

Companies that keep this analytics open