Index of every page on this site: llms.txt
All skills
onmax avatar

/before-after-evidence

@aecfada
by Maxonmax/comark-ui43 stars
3
Run it yourself

Shows a visible change as two comparable screenshots, before and after, with marks measured from the source and checked in the rendered page, and a change in motion as a short recording. Use when a pull request, bug fix, or design change alters what people see or how it moves, or when someone asks for before/after screenshots, a recording, or visual evidence.

Use this Skill: https://skilld.dev/gh/onmax/comark-ui/before-after-evidence

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencestour.md

≈674 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Video tour

A tour is a video made from the compare's own screenshots. It zooms to each mark, draws it, writes its note, cuts from before to after at the same place, and ends on the whole after. It gives a reviewer who won't study two half-width images a way in. The compare stays the evidence: the tour shows nothing the screenshots don't.

When to make one

  • The document has two or more marks, or several compares.
  • Skip it for one small change, such as a label: the compare says it at a glance.
  • Skip it for motion. Record that, as recording.md describes; a tour of stills can't show it.

1. Check it on one image

comark-annotate is already a direct dependency from step 4 of the skill. Add the canvas it draws with, then render 12 of the tour's frames on one image:

pnpm add -D @napi-rs/canvas
vp exec comark-annotate tour evidence.md --sheet tour-sheet.png

It draws with no browser. The sheet samples the tour and can skip notes; use it as a quick preview. Look at the sheet:

  • Each loop sits on what its note names, as it does on the page.
  • Each note reads whole, beside its mark.
  • Before and after alternate where the change is in one place on both sides.

A loop that misses its target comes from its annotation's box. Measure it again, as step 2 of the skill says, and render again; the tour has nothing to adjust by hand.

Continue when every frame on the sheet shows a mark on its target or the whole screenshot. This preview does not complete verification.

2. Render the video

vp exec comark-annotate tour evidence.md -o tour.mp4

It needs ffmpeg on the PATH. A 30-second tour is 1 to 4 MB at 1920×1080.

Before publishing, inspect every note shot in the rendered video, pausing after its note is fully written. Check every mark against its target and read each note whole beside it, including notes absent from the sheet. You can instead extract targeted frames with fully written notes for any the sheet missed. Done when every mark and its complete note have been checked. If a loop misses its target, remeasure the annotation and render both the sheet and video again.

3. Place it

Put it under the compare, after one line that says what it is, so no reader takes it for more evidence:

A tour of the same screenshots, change by change:

![A tour of the toolbar change: Filters wrap before, one row after](tour.mp4){width=1920 height=1080}

The alt text names the changes it walks through, for a reader whose browser can't play it. In a GitHub pull request description, a link to an MP4 hosted elsewhere doesn't play: drop the file into the description, so GitHub uploads it and the video plays there.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning6d3 checks · Risk SAFE
  • Gen Agent Trust Hub6d

    The skill provides a structured workflow for generating visual evidence (screenshots and recordings) of UI changes. It utilizes standard development tools like Playwright and ffmpeg, and installs utility packages authored by the developer from the npm registry. No malicious patterns or security risks were identified.

  • Socket6d

    No alerts

  • Snyk6d

    Risk: MEDIUM · 2 issues

Signed by skilld at aecfada. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week

README badge

README badge for onmax/comark-ui/before-after-evidence