К основному содержанию
скилл CX Codex

repo-timelapse — скилл для Claude Code: видео истории Git

Скилл repo-timelapse для Claude Code превращает историю репозитория в видео, где карта файлов меняется вместе с кодом. Запускается по просьбе показать развитие проекта или анимировать коммиты.

MIT ★ 541 обновлён 2026-11-09

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dotslashsimran/simcraft --skill repo-timelapse -a claude-code
Открыть на GitHub

Что делает repo-timelapse

repo-timelapse читает историю Git и собирает из неё видео: файлы образуют карту, окрашенную по языкам программирования, а их размер меняется вместе с кодом. В кадре появляются дата, счётчик строк, сообщения коммитов и график активности. Можно выбрать горизонтальный или вертикальный формат, светлую или тёмную тему.

Сначала extract.py создаёт JSON-отчёт с активностью по месяцам, крупными папками и массовыми коммитами; затем render.mjs делает видео. Историю можно ограничить датами или папкой, а перед финальным рендером посмотреть короткое превью. Скиллу нужны python3, git, node с Playwright и ffmpeg; без ffmpeg видео не соберётся.

Какие задачи решает

  • показать, как менялся код проекта по коммитам
  • собрать видео развития отдельной папки за выбранный период
  • подготовить вертикальный ролик о ходе разработки
  • скрыть имена авторов коммитов в видео

Примеры запросов агенту

  • Сделай видео, которое показывает, как рос мой репозиторий.
  • Покажи в ролике историю папки src/api за выбранный период.
  • Подготовь вертикальное видео по коммитам и скрой имена авторов.

Как установить repo-timelapse

1Через Skills CLI (Vercel)

npx skills add dotslashsimran/simcraft --skill repo-timelapse -a claude-code

2Вручную: положить файлы

~/.claude/skills/repo-timelapse/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/repo-timelapse/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о repo-timelapse

Как установить repo-timelapse в Claude Code?

Выполни npx skills add dotslashsimran/simcraft --skill repo-timelapse -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/repo-timelapse/SKILL.md.

Что делает repo-timelapse?

Он превращает историю Git в видео с картой файлов, датами, счётчиком строк, подписями-коммитами и графиком активности. Можно отфильтровать историю и настроить формат кадра и тему.

Что нужно для работы repo-timelapse?

Нужны python3, git, node с Playwright и ffmpeg. Чтобы выбрать конкретный ffmpeg, задаётся переменная FFMPEG.

Исходный текст

SKILL.md · MIT
---
name: repo-timelapse
description: Turn a git repo's history into a video of the project growing. Files appear as a living treemap coloured by language that grows with the code, glows when touched and fades on delete, with a date, a lines-of-code counter, commit messages typing in as captions and an activity sparkline. 16:9 or 9:16, dark or light. Use when the user says "timelapse of my repo", "visualise git history", "build in public video", "show how the project grew", "animate my commits", or wants a video of a codebase evolving.
---

# Repo timelapse

Two steps: read the history into a JSON file, then render it. Both only read the repo.

```
SK=~/simcraft/skills/video/repo-timelapse
python3 $SK/scripts/extract.py <repo> -o history.json
node $SK/scripts/render.mjs history.json preview.mp4 --preview
node $SK/scripts/render.mjs history.json timelapse.mp4
```

Needs python3, git, node with Playwright (already in the simcraft repo root), and ffmpeg (set `FFMPEG` to use a specific one).

## Steps

1. **Extract and read the report.** `extract.py` prints activity by month, the busiest 30 days, the biggest folders, bulk commits and a suggested duration. Use it to pick the story before rendering anything.

2. **Pick the story.** A whole repo is rarely the best video. Choose one arc and say it in one line, such as "the week I built the MVP" or "how the API folder took over". Narrow with:
   - `--since 2025-03-01 --until 2025-04-01` for a stretch of time,
   - `--path src/api` to film one folder,
   - `--exclude 'docs/**'` when docs, fixtures or generated files dwarf the code.
   Re-run extract after each change and check the report again.

3. **Clean the noise.** Lockfiles, vendored and build folders, minified files and test cassettes are skipped by default. Merge commits are folded into the main line, so line counts stay exact. If the report lists a bulk commit (an import or generated code), exclude its folder unless the import is the story.

4. **Preview.** Render with `--preview` (half size, 30fps, about 10 seconds for a 40-second video) and watch it. Check pacing, that captions are readable, and that the map is not dominated by one folder. For single frames use `--stills 3,12,25`, which writes PNGs into the output folder.

5. **Render the final** without `--preview`. It renders at 1080p and 60fps by default. A 30-second video takes about a minute.

6. **Report** the file path, the range and filters used, and anything excluded.

## Render options

- `--duration 30` sets the length in seconds. Use the suggestion from the report: about 20 seconds for a small repo, 40 to 60 for a big one.
- `--vertical` renders 1080x1920 for Reels, TikTok and Shorts. `--size 2560x1440` sets any size.
- `--theme light` switches to the light theme. Dark is the default.
- `--highlight src/api` dims everything outside that folder and shows its line count.
- `--title "My app"`, `--subtitle "..."`, `--end-text "part 2 next week"` change the cards. `--no-title` and `--no-end` remove them.
- `--grow fill` keeps the map full size from the first commit. The default `area` makes it grow with the code.
- `--fps 30` halves render time.

Extract options: `--anonymize` (Contributor 1, 2, ...), `--rev main`, `--name`, `--max-events 1500`, `--include-default-noise`.

## Pacing

- Quiet weeks are compressed automatically. Busy days get more screen time than empty ones, but a long pause never stops the video.
- Captions change at most about once a second. When several commits land close together, the most descriptive message is shown, so "wip" and "fix" rarely appear.
- Fewer than 10 commits makes a thin video. Pick a repo or range with at least 30.

## Posting

- The video opens on a title card, so put the hook in the post text: the final line count or the arc. For Reels, `--no-title` starts the motion in the first frame.
- For 9:16, the layout already keeps the top 150px and bottom 380px clear of platform buttons. Put your own text caption above the video in the editor, not over the map.
- Add a stacked caption in the post that names the arc, such as "60 days of building X, every commit".
- Anonymise authors for repos with other people's names in them, and check commit messages in the preview for anything private before posting.

How it works, the data format and the known limits: [reference.md](reference.md).

© dotslashsimran · MIT · dotslashsimran/simcraft

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
make-repo-contribution официальный github Скилл make-repo-contribution проверяет правила репозитория перед issue, веткой, коммитом или PR и помогает пройти процесс контрибьюции без пропуска обязательных шагов. CX Codex +1 11 073установок repo-story-time официальный github Скилл repo-story-time для GitHub Copilot анализирует кодовую базу и историю Git, создавая техническую сводку и рассказ о развитии проекта. Разбирает незнакомый репозиторий. CX Codex +1 8 900установок om-verify-in-repo open-mercato Скилл om-verify-in-repo для Claude Code проверяет задачи трекера перед запуском цепочки автоисправления. Оценивает репорт в режиме чтения и останавливает процесс токеном NO_ACTION_NEEDED при отсутствии бага. CX Codex +1 3 500установок github-multi-repo ruvnet Скилл github-multi-repo для работы с несколькими репозиториями сразу: сводит версии пакетов, проверяет кросс-пакетные интеграции и предлагает правки структуры. CX Codex +1 1 200установок repo-security-posture superagent-ai Скилл repo-security-posture проверяет настройки репозитория GitHub и CI/CD на уязвимости, формируя упорядоченный список задач для защиты кода от компрометации мейнтейнеров и атак на пайплайн. CX Codex +1 876установок gitops-repo-audit fluxcd Скилл gitops-repo-audit сканирует локальный GitOps-репозиторий Flux CD без подключения к кластеру. Находит устаревшие API, проверяет схемы манифестов Kubernetes и анализирует безопасность. CX Codex +1 719установок

Из того же набора24

Весь набор →
brand-kit Скилл brand-kit для Claude Code считывает оформление компании с её сайта и сохраняет его как бренд-кит. Запускается перед созданием видео, стикеров или графики для бренда. CX Codex +1 ★ 541звёзд репо next-step Скилл next-step для Claude Code превращает большую цель или поток задач в один следующий шаг. Агент подключает его, когда просят составить план, разбить задачу или помочь начать. CX Codex +1 ★ 541звёзд репо from-scratch Скилл from-scratch для Claude Code помогает понять принцип работы технологии через пошаговую сборку минимальной версии. Агент просит предсказать результат каждого шага, затем запускает код и сравнивает вывод с прогнозом. CX Codex +1 ★ 541звёзд репо video-script Скилл video-script для Claude Code пишет сценарии коротких разговорных видео, объяснений и демонстраций продукта. Включается по просьбе создать или исправить сценарий, хук либо ролик для YouTube, TikTok, Reels или LinkedIn. CX Codex +1 ★ 541звёзд репо skill-router Скилл skill-router для Claude Code выбирает навык под задачу или выстраивает цепочку из нескольких. Он включается, когда запрос расплывчатый или подходит под разные навыки. CX Codex +1 ★ 541звёзд репо bisect-anything Скилл bisect-anything для Claude Code находит коммит, версию зависимости или значение конфигурации, вызвавшие регрессию. Запускается на запросы вроде «что сломало тест» или «когда началась проблема». CX Codex +1 ★ 541звёзд репо scripted-screencast Скилл scripted-screencast для Claude Code превращает сценарий действий в браузере в запись демо продукта с курсором, масштабированием и подписями. Запускается по просьбе записать скринкаст или обновить ролик после изменений интерфейса. CX Codex +1 ★ 541звёзд репо security-threat-model Скилл security-threat-model для Claude Code строит модель угроз по коду приложения и проверяет найденные риски тестами. Запускается по запросу о безопасности, STRIDE или уязвимостях перед выпуском приложения. CX Codex +1 ★ 541звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой