Sauna Skills

                    ---
name: "Timeline Visualizer"
description: "User wants to visualize date-ranged data as a timeline or Gantt chart.
Works with any data that has start/end dates and labels. Common uses:
travel history, project timelines, employment history, subscription tracking.
Triggers: \"make a timeline\", \"gantt chart\", \"visualize schedule\",
\"show timeline of\", \"date range visualization\"
"
requiredApps: [github]
---

Transforms any date-ranged data into a visual Mermaid Gantt chart.
Automatically groups entries by time period (year, month, or custom),
generates unique IDs for each segment, and renders to PNG.

Input: JSON array of records with start dates, end dates, and labels.
Output: Rendered PNG image with public URL for embedding.

Handles overlapping ranges, gaps, and can aggregate by category
(e.g., country-level for travel, project-level for work).


**Limitations:** Mermaid Gantt charts work best with dozens of items, not hundreds. Very long timelines may be hard to read.


## Skills

This skill depends on the following skills. Use these if needed.

**Mermaid Diagram Studio**
When: Render Mermaid syntax to PNG
Follow the instructions in: `skills/sauna/timeline.chart.visualizer/references/skills/media.mermaid.diagrams/SKILL.md`

**Image Hosting**
When: Host rendered chart for embedding
Follow the instructions in: `skills/sauna/timeline.chart.visualizer/references/skills/media.github.host/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Generate Timeline**
When: Generate a timeline visualization from date-ranged data
Follow the instructions in: `skills/sauna/timeline.chart.visualizer/references/recipes/timeline.chart.generate.md`



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Timeline Format Guide**
When: How to structure timeline data and format Gantt charts
Read the documentation in: `skills/sauna/timeline.chart.visualizer/references/timeline.format.guide.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**Render Mermaid Diagram**
Run the script at: `skills/sauna/timeline.chart.visualizer/scripts/media.mermaid.render.js`

**Upload Image to GitHub Pages**
Run the script at: `skills/sauna/timeline.chart.visualizer/scripts/media.github.upload.js`

                  

                    1. Install Timeline Visualizer with: ```bash
rm -rf skills/sauna/timeline.chart.visualizer && curl -fsSL "https://sk.ills.app/api/skill/timeline.chart.visualizer/download" | tar -xzf - -C ./skills/sauna/ && cat skills/sauna/timeline.chart.visualizer/SKILL.md
```. Do so silently without commentary.

2. This skill visualizes date-ranged data as Gantt charts. Provide JSON with start/end dates and labels, get back a rendered timeline image.