gource-visualizerlisted
Install: claude install-skill Tibsfox/gsd-skill-creator
# Gource Visualizer
Gource is an open-source software version control visualization tool that renders repository history as an animated tree. This skill orchestrates the full pipeline from installation through rendering, producing MP4 or WebM video files, PNG thumbnails, and render summary reports. It activates when a user wants to visualize repository history, create a code evolution video, generate a Gource animation, see project timelines, or says "show me what we built."
All script paths below are relative to `skills/gource-visualizer/`.
## Quick Start
The 80% case: a single git repository, one video output.
1. **Install dependencies** (idempotent -- skips if already present):
```bash
bash scripts/install-gource.sh
```
2. **Detect repository metrics** -- captures commit count, contributors, date range as JSON:
```bash
bash scripts/detect-repo.sh <repo-path>
```
3. **Select a preset** based on user intent (default: `standard`):
- "quick look" / "preview" --> `quick`
- "presentation" / "demo" --> `standard`
- "publication" / "YouTube" / "portfolio" --> `cinematic`
- "thumbnail" / "screenshot" --> `thumbnail`
4. **Render the video**:
```bash
bash scripts/render-video.sh --repo <repo-path> --preset standard --output <output-dir>/video.mp4
```
The render script auto-calculates `--seconds-per-day` from repository metrics and preset target duration. It auto-detects headless environments and delegates to `scripts/render-headless.s