screen-capture

Captures real application screenshots via headless Chromium and Playwright for documentation.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/gweone/agent-plugins --skill screen-capture-gweone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screen-capture
Source: https://github.com/gweone/agent-plugins/tree/main/plugin/sharpps-work/skills/screen-capture
Command: npx skills add https://github.com/gweone/agent-plugins --skill screen-capture-gweone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright.

What problem does it solve? Creating user guides and manuals requires real screenshots of a running application, but capturing them is error-prone: local multi-tenant or reverse-proxied apps reject requests with the wrong Host header, login flows need automation, and fragile selectors silently capture the wrong page. This Skill provides a proven Playwright-based workflow that handles these pitfalls. ## Core Features & Use Cases - Headless browser capture: Drives Chromium via Playwright to log in, navigate, and screenshot real application screens on Windows, macOS, and Linux. - Multi-tenant/reverse-proxy handling: Uses Chromium's --host-resolver-rules flag to map a real domain to a local instance, solving Host-header routing problems common in self-hosted apps like Frappe/ERPNext. - Session reuse and credential hygiene: Saves login state via storageState per user role and keeps secrets out of command output and transcripts. - Selector robustness and visual debugging: Avoids silently-wrong captures through scoped selectors, explicit waits, and read-back verification of every screenshot. - Use Case: Document an ERPNext login and order-entry flow for a user manual by capturing each screen as a specific role, with ordered filenames ready to drop into a document. ## Quick Start Use the screen-capture skill to log into my local app and take screenshots of the login, dashboard, and order creation screens for a user guide.

Frequently Asked Questions about screen-capture

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

FAQPage Schema
How do I take automated screenshots of a web app with Playwright?

Install Playwright with npm install playwright and npx playwright install chromium, then launch Chromium, navigate to each page, and call page.screenshot. Automate login first and save the session with storageState so later capture scripts skip re-authentication.

How do I screenshot a local multi-tenant app that rejects localhost?

Launch Chromium with --host-resolver-rules mapping the real domain to the local IP, then navigate using that real hostname so the Host header is naturally correct. Rewriting the Host header via request interception is unreliable and should be avoided.

Does Playwright screen capture work on Windows, macOS, and Linux?

Yes, the same Playwright install commands and capture JavaScript work identically on all three platforms. Only environment details differ, such as the Linux-only --with-deps flag and the OS-specific hosts file paths.

Why does my Playwright script screenshot the wrong page?

Bare text selectors like page.click('text=Create') can match unrelated sidebar elements and navigate elsewhere without throwing an error. Scope selectors to the actual container, target grid rows by explicit index attributes, and read back every screenshot to verify.

How do I reuse a login session across Playwright capture scripts?

After logging in once, save the session with context.storageState to a JSON file, then create new browser contexts with that storageState. Save a separate state file per user role, and delete these files after capture since they contain session cookies.