skills.rest
mikeyobrien
mikeyobrienCOMMUNITY
Explore all skills by this author →
Website𝕏@mikeyobrienvGitHub

pr-demo

Record terminal sessions with asciinema and convert them to GIFs or SVGs for GitHub PRs.

3.1k|286|Updated Sep 7, 2025
Search Tags:#documentation#SVG#PR#GIF#embedding#asciinema#terminal-demo
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill pr-demo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-demo
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/pr-demo
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill pr-demo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams create engaging terminal demos for pull requests and documentation by recording live terminal sessions and converting them into GIFs or SVGs suitable for embedding in GitHub.

Core Features & Use Cases

  • Recording: Capture terminal sessions with asciinema.
  • Conversion & Embedding: Convert recordings to GIFs via agg or SVGs via svg-term-cli for GitHub embedding.
  • Use Case: When explaining new features in PRs or docs, replace long descriptions with a short, animated demo.

Quick Start

Install prerequisites, record a demo, convert to GIF or SVG, and embed in your PR or docs.

Frequently Asked Questions about pr-demo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a terminal demo for a GitHub PR?▼

To create a terminal demo for a GitHub PR, record your terminal session using asciinema, convert the recording to a GIF or SVG, and embed the resulting file directly in your pull request documentation.

How do I convert asciinema recordings to SVG or GIF for embedding?▼

Convert asciinema recordings to GIF or SVG by using agg for GIF output or svg-term-cli for SVG output, generating embeddable animated files suitable for GitHub documentation and pull requests.

What is the best way to document terminal commands with animated demos?▼

The best way to document terminal commands with animated demos is recording live sessions with asciinema and converting them into lightweight GIFs or SVGs, replacing long text descriptions with visual demonstrations.

Do I need asciinema to record terminal sessions for documentation?▼

Yes, you need asciinema to record live terminal sessions for documentation. The skill utilizes asciinema for capture and requires agg or svg-term-cli to convert the recordings into embedded GIF or SVG formats.

Should I use GIF or SVG for embedding terminal demos in GitHub?▼

SVG offers scalable, lightweight terminal demos for GitHub embedding, while GIF provides broader compatibility. Convert asciinema recordings using svg-term-cli for SVG or agg for GIF based on your documentation needs.

When should I use terminal demos instead of text in pull requests?▼

Use terminal demos instead of text in pull requests when explaining new features or onboarding workflows, replacing lengthy descriptions with short, shareable animated demonstrations that clearly show terminal interactions.

Related Skills

Explore More Design & Creative Skills→
Happyverse-TeamHappyverse-Team

pr-demo

Record terminal sessions and convert them to GIF or SVG formats.

Official
Advanced
abcnutsabcnuts
60

mcp-connector-tester

Automate MCP connector testing and generate templated Markdown documentation.

Community
Advanced
phrazzldphrazzld
13

pr-walkthrough

Capture screenshots, browser GIFs, and terminal output into a Pull Request body.

Community
Intermediate
aroidoaroido

Screenshot Automation

Automates application screenshots and creates GIFs via Playwright and ffmpeg.

Official
Intermediate