Generate horizontal Gantt charts from schedule data via the bundled scripts/gantt.py toolkit.
The gantt() function accepts a DataFrame or file path plus column names, and saves a PNG (returning the path).
It handles theming, date parsing, bar colour-coding, completion overlays, today-line, legend, and saving.
Instructions
Provide the data source: a pandas DataFrame, or a path to a .csv / .tsv / .json file.
- One row = one task / phase.
- Required columns: a phase/task name column, a start date column, and either an end date column OR a duration-in-days column.
Import and call gantt():
import sys
sys.path.insert(0, "scripts") # adjust path to where gantt.py is deployed
from gantt import gantt
# Basic — start + end columns
gantt("schedule.csv", phase="Phase", start="Start", end="End",
title="Project Schedule", out="gantt.png")
# Group colour-coding + today line
gantt(df, phase="phase", start="planned_start", end="planned_end",
group="project", today=True, out="schedule.png")
# Duration instead of end date
gantt(df, phase="task", start="start_date", duration="days",
out="schedule.png")
# Completion % hatch overlay
gantt(df, phase="Phase", start="Start", end="End",
completion="PctDone", out="gantt.png")
- See
references/cheatsheet.md for full parameter reference and CLI examples.
Bundled files
scripts/gantt.py — the full toolkit (load_data, apply_theme, save_fig, gantt, CLI)references/cheatsheet.md — parameter quick-reference and copy-paste examplesassets/sample_schedule.csv — demo dataset that exercises every feature
Defaults & behaviour
- Colorblind-friendly palette (matches chart-builder skill for visual consistency).
- Date axis auto-scales: weekly ticks ≤90 days, monthly ≤365 days, bi-monthly beyond.
- Bars ordered top-to-bottom matching input row order.
- Rows with missing phase or start values are silently dropped before drawing.
- Output PNG at 150 DPI by default.
- Provide
end OR duration — not both; end takes priority if both are present.
1---2name: gantt-chart-generator3description: Use this skill whenever the user asks to visualize a project schedule, timeline, Gantt chart, or phase/task breakdown over time. It gives the agent a prebuilt, parameterized gantt() function so Gantt charts are produced instantly and consistently — with colour-coded groups, completion overlays, a today reference line, and auto-scaled date axes — instead of hand-writing matplotlib each time.4---56Generate horizontal Gantt charts from schedule data via the bundled `scripts/gantt.py` toolkit.7The `gantt()` function accepts a DataFrame or file path plus column names, and saves a PNG (returning the path).8It handles theming, date parsing, bar colour-coding, completion overlays, today-line, legend, and saving.910## Instructions11121. Provide the data source: a pandas DataFrame, or a path to a `.csv` / `.tsv` / `.json` file.13 - One row = one task / phase.14 - Required columns: a **phase/task name** column, a **start date** column, and either an **end date** column OR a **duration-in-days** column.15162. Import and call `gantt()`:1718```python19import sys20sys.path.insert(0, "scripts") # adjust path to where gantt.py is deployed21from gantt import gantt2223# Basic — start + end columns24gantt("schedule.csv", phase="Phase", start="Start", end="End",25 title="Project Schedule", out="gantt.png")2627# Group colour-coding + today line28gantt(df, phase="phase", start="planned_start", end="planned_end",29 group="project", today=True, out="schedule.png")3031# Duration instead of end date32gantt(df, phase="task", start="start_date", duration="days",33 out="schedule.png")3435# Completion % hatch overlay36gantt(df, phase="Phase", start="Start", end="End",37 completion="PctDone", out="gantt.png")38```39403. See `references/cheatsheet.md` for full parameter reference and CLI examples.4142## Bundled files43- `scripts/gantt.py` — the full toolkit (load_data, apply_theme, save_fig, gantt, CLI)44- `references/cheatsheet.md` — parameter quick-reference and copy-paste examples45- `assets/sample_schedule.csv` — demo dataset that exercises every feature4647## Defaults & behaviour48- Colorblind-friendly palette (matches chart-builder skill for visual consistency).49- Date axis auto-scales: weekly ticks ≤90 days, monthly ≤365 days, bi-monthly beyond.50- Bars ordered top-to-bottom matching input row order.51- Rows with missing phase or start values are silently dropped before drawing.52- Output PNG at 150 DPI by default.53- Provide `end` OR `duration` — not both; `end` takes priority if both are present.
Microsoft