# Send terminal-screenshots to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "terminal-screenshots",
    "name": "terminal-screenshots",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ricardodantas/terminal-screenshots",
    "canonicalUrl": "https://clawhub.ai/ricardodantas/terminal-screenshots",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/terminal-screenshots",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=terminal-screenshots",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "terminal-screenshots",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T18:06:12.888Z",
      "expiresAt": "2026-05-19T18:06:12.888Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=terminal-screenshots",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=terminal-screenshots",
        "contentDisposition": "attachment; filename=\"terminal-screenshots-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "terminal-screenshots"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/terminal-screenshots"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/terminal-screenshots",
    "downloadUrl": "https://openagent3.xyz/downloads/terminal-screenshots",
    "agentUrl": "https://openagent3.xyz/skills/terminal-screenshots/agent",
    "manifestUrl": "https://openagent3.xyz/skills/terminal-screenshots/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/terminal-screenshots/agent.md"
  }
}
```
## Documentation

### Terminal Screenshots & Recordings with VHS

Generate terminal screenshots and animated GIFs/videos using VHS from Charmbracelet.

### When to Use This Skill

Creating terminal screenshots for documentation
Recording animated GIFs of CLI demos
Generating video tutorials for command-line tools
Producing consistent, reproducible terminal visuals
Integration testing with golden file comparisons

### Check Installation

# Check if vhs is installed
which vhs && vhs --version

# Check dependencies
which ttyd && which ffmpeg

### Installation

Recommended: Homebrew (macOS/Linux)

brew install vhs

This installs VHS with all required dependencies (ttyd, ffmpeg).

Other methods:

# Fedora/RHEL
echo '[charm]
name=Charm
baseurl=https://repo.charm.sh/yum/
enabled=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
sudo dnf install vhs ffmpeg
# Also install ttyd: https://github.com/tsl0922/ttyd/releases

# Arch Linux
pacman -S vhs

# Docker (includes all dependencies)
docker run --rm -v $PWD:/vhs ghcr.io/charmbracelet/vhs <cassette>.tape

### 1. Create a Tape File

vhs new demo.tape

### 2. Edit the Tape File

Tape files are simple scripts that describe what to type and capture.

### 3. Run VHS

vhs demo.tape

### Output Formats

Output demo.gif          # Animated GIF
Output demo.mp4          # Video file
Output demo.webm         # WebM video
Output frames/           # PNG sequence (directory)

You can specify multiple outputs in one tape file.

### Settings (Must Be at Top)

# Terminal dimensions
Set Width 1200
Set Height 600

# Font settings
Set FontSize 22
Set FontFamily "JetBrains Mono"

# Appearance
Set Theme "Catppuccin Mocha"
Set Padding 20
Set Margin 20
Set MarginFill "#1e1e2e"
Set BorderRadius 10
Set WindowBar Colorful

# Behavior
Set Shell "bash"
Set TypingSpeed 50ms
Set Framerate 30
Set CursorBlink false

### Common Themes

Run vhs themes to see all available themes. Popular ones:

Catppuccin Mocha, Catppuccin Frappe
Dracula
Tokyo Night
Nord
One Dark

### Commands

CommandDescriptionExampleType "text"Type charactersType "echo hello"Type@500ms "text"Type slowlyType@500ms "important"EnterPress EnterEnterEnter 2Press Enter twiceEnter 2Sleep 1sWait durationSleep 500msBackspaceDelete characterBackspace 5TabPress TabTabSpacePress SpaceSpaceCtrl+CControl sequencesCtrl+LUp/Down/Left/RightArrow keysUp 3HideStop recording framesHideShowResume recordingShowScreenshot file.pngCapture current frameScreenshot out.pngWait /regex/Wait for text to appearWait /\\$\\s*$/Env KEY "value"Set environment variableEnv PS1 "$ "Require programFail if program missingRequire gitSource file.tapeInclude another tapeSource setup.tape

### Escaping Quotes

Use backticks to escape quotes:

Type \`echo "hello world"\`
Type \`VAR='value'\`

### Static Screenshot

Output screenshot.png

Set Width 800
Set Height 400
Set FontSize 18
Set Theme "Catppuccin Mocha"
Set Padding 20

# Hide setup
Hide
Type "clear"
Enter
Show

# The actual content
Type "ls -la"
Enter
Sleep 500ms

Screenshot screenshot.png

### Animated Demo GIF

Output demo.gif

Set Width 1000
Set Height 500
Set FontSize 20
Set Theme "Dracula"
Set TypingSpeed 50ms
Set Padding 20
Set WindowBar Colorful

# Clean start
Hide
Type "clear"
Enter
Show

# Demo sequence
Type "echo 'Hello from VHS!'"
Sleep 300ms
Enter
Sleep 1s

Type "date"
Enter
Sleep 1s

Type "echo 'That was easy!'"
Enter
Sleep 2s

### MP4 Video with Clean Prompt

Output tutorial.mp4

Set Width 1200
Set Height 600
Set FontSize 24
Set Theme "Tokyo Night"
Set Shell "bash"
Set Framerate 30

# Set a clean, minimal prompt
Hide
Env PS1 "$ "
Type "clear"
Enter
Show

Type "# Welcome to the tutorial"
Enter
Sleep 1s

Type "git status"
Enter
Sleep 2s

Type "git log --oneline -5"
Enter
Sleep 3s

### 1. Hide Setup/Cleanup

# Setup (hidden)
Hide
Type "cd ~/project && clear"
Enter
Show

# Your demo here...

# Cleanup (hidden)
Hide
Type "cd - && rm temp-files"
Enter

### 2. Use a Simple Prompt

Hide
Env PS1 "$ "
Type "clear"
Enter
Show

### 3. Control Timing

Use Sleep liberally for readability
Sleep 500ms after typing, before Enter
Sleep 1s to 2s after command output
End with Sleep 2s or more for the final frame

### 4. Typing Speed

# Default speed for setup
Set TypingSpeed 10ms

# Slow down for important parts
Type@100ms "Important command here"

### 5. Wait for Output

Type "npm install"
Enter
Wait /added \\d+ packages/  # Wait for completion message
Sleep 1s

### 6. Screenshot at Key Moments

Type "make build"
Enter
Wait /Build complete/
Screenshot build-success.png

### Workflow for Documentation

Plan your demo sequence
Create a .tape file with settings
Test with vhs demo.tape (generates output)
Iterate - adjust timing, dimensions, theme
Commit both the .tape file and output to your repo

### Recording Real Sessions

You can record your terminal and generate a tape file:

vhs record > session.tape

Then edit the generated tape file to clean it up.

### File Reference

See example tape files in this skill directory:

basic-screenshot.tape - Simple static screenshot
demo-recording.tape - Animated GIF demo

### Resources

VHS GitHub
VHS Themes
Example Tapes
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ricardodantas
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T18:06:12.888Z
- Expires at: 2026-05-19T18:06:12.888Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/terminal-screenshots)
- [Send to Agent page](https://openagent3.xyz/skills/terminal-screenshots/agent)
- [JSON manifest](https://openagent3.xyz/skills/terminal-screenshots/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/terminal-screenshots/agent.md)
- [Download page](https://openagent3.xyz/downloads/terminal-screenshots)