SkillAgentSearch skills...

timeline-builder

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.

Install / Use

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

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

Tags

Our assessment of timeline-builder

timeline-builder scores 91/100 on our quality scale, 1028th of 4,698 Development & Engineering skills we index (top 22%).

Its SKILL.md is 3.6 KB long, well organised into 10 sections with 4 code examples: a solid amount of guidance for an agent.

With 4,652 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 39 days ago, so timeline-builder is actively maintained.
  • Our last check on 2026-10-28 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

timeline-builder compared with similar skills

All 4 of these similar skills score higher than timeline-builder; compare them before choosing.

SkillScoreStarsUpdatedFormat
timeline-builder (this skill)by zebbern914.7k39d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install timeline-builder?
Run npx skills add zebbern/claude-code-guide --skill timeline-builder. The install tabs above show the steps for each supported agent.
Which AI agents does timeline-builder work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is timeline-builder safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is timeline-builder still maintained?
The repository was last updated 39 days ago, so timeline-builder is actively maintained.

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

python3 scripts/generate_timeline.py --config timeline_data.json --output timeline.html

Read JSON from stdin

cat timeline_data.json | python3 scripts/generate_timeline.py --stdin --output timeline.html

Override layout mode (takes precedence over config file)

python3 scripts/generate_timeline.py --config data.json --layout horizontal --output timeline.html

JSON Configuration Format

{
  "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)

Related Skills

View on GitHub
GitHub Stars4.7k
CategoryDevelopment
Updated1mo ago
Forks468

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions