screenshot

Capture terminal screenshots across Windows, macOS, and Linux.

4|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/lirrensi/agent-cli-helpers --skill screenshot-lirrensi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/lirrensi/agent-cli-helpers/tree/main/skills/screenshot
Command: npx skills add https://github.com/lirrensi/agent-cli-helpers --skill screenshot-lirrensi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Take screenshots from the terminal across platforms to document status, share results, and automate visual checks without a GUI. This skill enables quick and consistent capture of terminal screens for debugging, reporting, and demonstrations.

Core Features & Use Cases

  • Cross-platform terminal screenshot capture for Windows, macOS, and Linux
  • Automatic file naming and path output for easy scripting and automation
  • Fallback to native tools when the primary capture method is unavailable for reliability Use cases include automated test reports, bug reproduction captures, and visual confirmations in CI/CD logs.

Quick Start

Run the screenshot command to capture the current screen to a file.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I take a terminal screenshot for CI/CD visual checks?

To take a terminal screenshot for CI/CD visual checks, run the screenshot command in your automation script. The tool automatically captures the current screen to a file and outputs the saved file path for easy integration.

Does the screenshot CLI tool support cross-platform screen capture on Windows and Linux?

Yes, the screenshot CLI tool supports cross-platform screen capture on Windows, macOS, and Linux. It automatically falls back to native capture methods if the primary tool is unavailable, ensuring reliable operation.

How do I automate screen capture and return the saved file path in bash scripts?

You can automate screen capture and return the saved file path in bash scripts by executing the screenshot command. It performs automatic file naming, saves the capture, and returns the exact file path string for downstream scripting.

What is the best way to capture terminal screenshots for bug reproduction?

The best way to capture terminal screenshots for bug reproduction is using an automated CLI tool. It captures consistent visual states across Windows, macOS, and Linux without requiring a GUI, outputting the saved file path directly.

Why does my automated screenshot capture fail in headless environments?

Automated screenshot capture may fail in headless environments if the primary capture method is unavailable. This tool falls back to native OS capture commands to maintain reliability, but requires a display context to function properly.

Can I use terminal screen capture for automated test reports without a GUI?

Yes, you can use terminal screen capture for automated test reports without a GUI. The CLI tool captures the current screen state to a file, allowing visual confirmations and bug reproduction captures to be logged in automation workflows.