sg-record

Record browser interactions and export ShipGuard YAML test manifests.

7|2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/bacoco/ShipGuard --skill sg-record
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-record
Source: https://github.com/bacoco/ShipGuard/tree/main/plugins/shipguard/skills/sg-record
Command: npx skills add https://github.com/bacoco/ShipGuard --skill sg-record

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recording browser interactions and turning them into ShipGuard YAML manifests, eliminating manual test scripting.

Core Features & Use Cases

  • Macro recording: captures user interactions via a floating toolbar and translates them into ShipGuard YAML manifests.
  • Deterministic output: produces reproducible manifests that integrate with sg-visual-run and review pages.
  • Lifecycle bootstrap: installs recorder runtime, manages auth state, and supports replay-ready tests for visual regression and automation pipelines.

Quick Start

Run the sg-record skill against your URL to start recording sessions and generate a manifest.

Frequently Asked Questions about sg-record

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

FAQPage Schema
How do I record browser interactions into YAML test manifests automatically?

To record browser interactions into YAML test manifests, you run a recorder against your target URL that captures user steps via a floating toolbar and exports ready-to-play ShipGuard YAML files under visual-tests/manifests.

Do I need Playwright installed to record browser actions for visual testing?

Yes, you need Playwright installed locally to record browser actions. The recorder requires the Playwright runtime to bootstrap the recording session, capture interactions, and manage persistent auth state when requested.

How does a browser action recorder generate reproducible visual regression tests?

A browser action recorder generates reproducible visual regression tests by capturing deterministic user steps through a floating toolbar and translating them directly into structured ShipGuard YAML manifests for the automation pipeline.

Can I persist authentication state when recording browser automation manifests?

Yes, you can persist authentication state when recording browser automation manifests. The recorder lifecycle bootstrap manages auth state during the session, ensuring your exported YAML tests are replay-ready for authenticated visual regression scenarios.

What is the best way to automate test scripting without manual YAML coding?

The best way to automate test scripting without manual YAML coding is using a macro recorder that captures browser interactions through a floating toolbar and automatically translates them into deterministic ShipGuard YAML manifests for visual regression pipelines.

Why are my recorded browser manifests not integrating with my visual regression pipeline?

Recorded browser manifests may not integrate with your visual regression pipeline if they are not placed under the visual-tests/manifests directory or if the output lacks deterministic formatting required by downstream visual review pages and run environments.