pr-demo

Skill do tworzenia polished animowanych demonstracji CLI dla GitHuba. Nagrywaj sesje terminala za pomocą asciinema, konwertuj do GIF-ów lub SVG i osadzaj bezpośrednio w pull requestach. Idealny dla dokumentacji zmian, które wymagają wizualnego wyjaśnienia — zamiast statycznych screenshotów, pokażesz działające komendy w akcji. Obsługuje zarówno małe pliki (SVG poniżej 500KB) jak i natywnie renderowane przez GitHub GIF-y.

1. Zainstaluj wymagane narzędzia: asciinema, agg (do konwersji GIF) i opcjonalnie svg-term-cli dla formatu SVG. Na macOS użyj brew install asciinema, następnie cargo install --git https://github.com/asciinema/agg. 2. Przygotuj skrypt demo — napisz krótki plan (20–30 sekund), w którym określisz, co chcesz pokazać: wpisanie komendy, jej wykonanie i wynik. Jedno działanie, jasno. 3. Przygotuj terminal: wyczyść ekran (clear), ustaw prosty prompt (export PS1='$ ') i rozmiar 100x24 kolumn na 24 wiersze, aby demo było czytelne po zmniejszeniu. Ukryj wrażliwe dane (klucze API, ścieżki z usernamami). 4. Nagraj sesję poleceniem asciinema rec demo.cast --cols 100 --rows 24, wykonaj zaplanowane kroki w czytelnym tempie, rób krótkie pauzy po ważnych momentach, a na koniec wpisz exit. Jeśli się pomylisz, nagrywaj od nowa — edycja jest trudniejsza. 5. Konwertuj nagranie do GIF-a poleceniem agg demo.cast demo.gif — to da ci plik poniżej 5MB, który GitHub renderuje natywnie. Jeśli potrzebujesz mniejszego pliku, użyj svg-term-cli do konwersji na SVG. 6. Osadź wynik w pull request lub dokumentacji, linkując do pliku GIF lub SVG — czytelnicy zobaczą animowaną demonstrację zamiast statycznego zrzutu ekranu.