P
pr-demo
Use when creating animated demos (GIFs) for pull requests or documentation. Covers terminal recording with asciinema and conversion to GIF/SVG for GitHub embedding.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Use when creating animated demos (GIFs) for pull requests or documentation. Covers terminal recording with asciinema and conversion to GIF/SVG for GitHub embedding.
How to use
- 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.