software-mansion/argent

argent-screenshot-diff

Compare saved or live app screenshots with the argent screenshot-diff tool.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/software-mansion/argent --skill argent-screenshot-diff

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

1. Role

Use screenshot-diff as supporting visual evidence for UI QA and visual regression checks. It highlights pixel-visible change or stability; it does not replace visual inspection, accessibility/component-tree state, frame/attribute checks, logs, network evidence, or app behavior. Its description covers the input combinations, physical-iPhone captures and the result.

Do not use screenshot diffing for tap-coordinate discovery. Use describe to find targets first.

2. When To Use

  • Required for explicit "UI regression test", "visual regression test", "screenshot diff", "compare screenshots", or "before/after visual comparison" requests, unless stable comparable screenshots cannot be produced.
  • Good fit when the expected result is pixel-visible, or when the risk is an unintended visual regression outside the exact element changed.
  • Poor fit when the result is better verified structurally: state changes, navigation existence, accessibility tree contents, console/network behavior, or unit tests.
  • Poor fit when dynamic content, unpausable animation, timestamps, ads, random data, or missing baseline/current screenshots would make the comparison noisy or meaningless.

3. Deterministic Flow

  1. Navigate to the known-good state. Capture the baseline before the relevant interaction or before editing whenever feasible.
  2. Save a baseline PNG with screenshot using scale: 1.0 and includeImageInContext: false, so the full-size image stays out of context; keep the returned path. Use normal downscaled screenshots for everything else.
  3. Perform the interaction, apply the code change and navigate to the state under test, after the app reloads or rebuilds.
  4. Call screenshot-diff with that baselinePath, captureCurrent: true, udid, and outputDir. If both images are already saved, pass currentPath instead of captureCurrent.
  5. Inspect the summary and artifact paths, then combine the diff with normal visual inspection and any structural/runtime evidence needed for the assertion.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
software-mansion
커뮤니티

argent-android-emulator-setup

Set up and connect to an Android emulator using argent MCP tools. Use when starting a new session on Android, booting an emulator, getting a device serial, or before any UI interaction task.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-create-e2e

Create, record, edit, replay, or repair reusable Argent e2e test YAML files. Use when the user asks to record, replay, or run an e2e test or a repeatable device path, set up profiling or an A/B comparison, or invoke the authoring engine behind argent-qa-e2e. Also use before repeating three or more interactions. For one-off UI checks, acceptance-driven regression tests, or screen video, use argent-test-ui-flow, argent-qa-e2e, or argent-screen-recording respectively.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-device-interact

Interact with an iOS simulator or iPhone, Android emulator or phone, or Chromium (CDP) app using argent MCP tools. Use when tapping UI elements, performing gestures, scrolling/swiping, typing text, pressing hardware buttons, launching apps, opening URLs, taking screenshots, waiting for an element to appear or disappear, or checking visible app state after interactions. Not for TV targets.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-ios-device-interact

Drive a physical iPhone through argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator. For cable, trust, or signing problems read argent-ios-device-setup.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일