A professional workflow for recording, converting, and validating terminal sessions into animated GIFs and SVGs for pull requests.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pr-demo
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pr-demo using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PR Demo Creation?
This skill facilitates the creation of high-quality terminal demonstrations specifically designed for pull requests and technical documentation. By utilizing Openclaw Skills, developers can automate the transition from a live terminal session to a polished, embeddable GIF or SVG. This process ensures that reviewers and users can instantly visualize the impact of code changes without manually running commands, significantly improving the communication efficiency of any software project.
The toolset integrates asciinema for recording, agg for high-performance GIF generation, and specialized validation logic to keep files small and secure. Using Openclaw Skills for this workflow helps maintain a standard of excellence in project transparency and documentation quality.
PR Demo Creation Use Cases
- Demonstrating new CLI features or flags in a pull request.
- Creating visual bug reports to show the exact steps to reproduce an issue.
- Building technical tutorials and documentation that require terminal-based walkthroughs.
- Capturing TUI application behavior for design reviews.
How PR Demo Creation Works
- Scripting: Prepare a concise 20-30 second script to ensure the demo remains focused and effective.
- Environment Preparation: Reset the terminal state, simplify the command prompt, and hide sensitive paths or API keys.
- Recording: Use asciinema to capture the terminal session into a lightweight .cast file.
- Conversion: Process the recording using agg to generate an optimized GIF or svg-term-cli for a vector-based animation.
- Validation: Run automated checks for file size and duration, followed by an LLM-assisted security scan for leaked secrets.
- Embedding: Move the final asset to the documentation folder and link it directly within the GitHub PR description.
PR Demo Creation Setup
To get started with this workflow in Openclaw Skills, install the necessary dependencies via your package manager:
# Install core recording and conversion tools
brew install asciinema
cargo install --git https://github.com/asciinema/agg
# Optional: Install SVG converter and TUI snapshot tool
npm install -g svg-term-cli
brew install charmbracelet/tap/freeze
PR Demo Creation Data Schema & Taxonomy
The skill manages terminal session data and assets through a structured hierarchy:
| File Extension | Purpose | Metadata Captured |
|---|---|---|
.cast |
Raw session data | Duration, terminal dimensions, input events |
.gif |
Final output asset | Frame rate, font size, speed multiplier |
.svg |
Vector animation | Window styling, timestamp markers |
.png |
Static snapshot | Syntax highlighting, terminal theme |
PR Demo Creation Advanced Features
- Intelligent LLM-as-judge validation to verify text readability and demo value.
- Automated sensitive information scanning within the .cast JSON stream to prevent credential leaks.
- Adjustable playback speed (1.0x to 1.5x) to maintain engagement while keeping demonstrations brief.
- Support for custom terminal dimensions (100x24) to ensure consistency across different viewing environments.
- Multi-tool chain selection based on output size requirements (GIF vs SVG).
SKILL.md
Loading
Related Openclaw Skills
playwriter
A browser automation tool that executes Playwright scripts against persistent, local Chrome sessions to preserve logins and extensions.
pdd (Prompt-Driven Development)
A structured AI agent skill that converts vague project ideas into comprehensive technical specifications and step-by-step implementation plans through iterative refinement.
Find Code Tasks
A specialized utility for listing and filtering code tasks within a repository to maintain a clear overview of project status.
Evaluate Presets
A specialized testing framework for validating AI agent persona presets and auditing routing performance through automated CLI scripts.
Ralph Operations
A comprehensive toolkit for monitoring, diagnosing, and managing Ralph orchestration loops and session diagnostic data.
Ralph Tools
A foundational toolset for AI agents to interact with the local filesystem and retrieve online technical documentation.
Featured*
