Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

ccvd

/ccvd

Porównuje wygląd stron przed i po zmianie, tworzy zrzuty ekranu do pull requesta i szuka regresji wizualnych.

Repozytorium
ccvd ↗
Licencja
MIT
Ostatnia zmiana repozytorium
29.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 29.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Porównuje wygląd stron przed i po zmianie, tworzy zrzuty ekranu do pull requesta i szuka regresji wizualnych.

Oryginalny opis (EN)

Use when comparing how a web page or site looks before and after a change (two commits, branches, deployments or URLs), when making before and after screenshots for a pull request, or when checking a UI change or refactor for visual regressions.

Jak działa

  1. 1. Get two addresses
  2. 2. Live view for the user
  3. 3. Images for a PR, or to check your own work
  4. 4. Clean up
  5. Common mistakes
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 749 słów
Podgląd SKILL.md
---
name: ccvd
description: Use when comparing how a web page or site looks before and after a change (two commits, branches, deployments or URLs), when making before and after screenshots for a pull request, or when checking a UI change or refactor for visual regressions.
---

# ccvd: Claude Code Visual Diff

ccvd renders two versions of a site in one hidden Chromium and compares them pixel by pixel. Changed pixels are red; everything else is shown faded. It has two modes:

- **Live view**, for the user: before, diff and after side by side in their browser, with scrolling, clicks, typing and links mirrored to both sides.
- **shot**, for you: before, after, diff and composite PNGs per page and size, with the count of changed pixels.

Run it as `npx -y @laveez/ccvd@0.1.2`, with the before address first and the after address second. It needs Google Chrome, or the Chromium from `npx -y playwright-core install chromium`.

## 1. Get two addresses

ccvd compares two running sites. Use deployed URLs as they are (production against a local dev server works too). To compare two git versions of the project:

1. Check out each version into its own folder outside the working tree: `git worktree add --detach <dir> <ref>`, or `git archive <ref> | tar -x -C <dir>` when the build does not need git.
2. Install dependencies in each folder if the project needs them.
3. Start the project's own dev server in each folder, in the background, on two free ports on 127.0.0.1, and note how to stop each one (its process id, or your tool's background task). Find the command in the README or `package.json` scripts. Examples: `npm run dev -- --port 8101`, `php -S 127.0.0.1:8101`, `python3 -m http.server 8101 --bind 127.0.0.1 --directory <dir>`.
4. Wait until both servers answer before running ccvd.

## 2. Live view for the user

Run in the background; it keeps running until stopped:

```bash
npx -y @laveez/ccvd@0.1.2 http://127.0.0.1:8101/ http://127.0.0.1:8102/
```

It opens the view in the user's browser and prints its address (`Open http://127.0.0.1:2283/?t=…`). Give the user that address. Add `--no-open` when the user is on another machine. Useful options: `--size desktop|laptop|tablet|phone|WIDTHxHEIGHT`, and `--no-reduced-motion` when the user wants to see the pages' animations (reduced motion is on by default, so animated pages hold still).

## 3. Images for a PR, or to check your own work

```bash
npx -y @laveez/ccvd@0.1.2 shot http://127.0.0.1:8101/ http://127.0.0.1:8102/ --path / --path pricing.html --size desktop --size phone --out <dir> --json
```

- Take each `--path` from the site's own links: `pricing.html` on a plain static server, `/pricing` on most frameworks. It resolves against each address like a link. Without `--path`, both addresses are captured as given, query and hash included.
- Sizes: `desktop` 1920x1080, `laptop` 1440x900, `tablet` 768x1024, `phone` 440x956, or `WIDTHxHEIGHT`. Full page by default; `--viewport` for the visible part only.
- Files are `<dir>/<page>-<WIDTH>x<HEIGHT>-<kind>.png`. The page is named after its path (`/` is `index`), and kind is `before`, `after`, `diff`, `pair` (before and after, labelled) or `triple` (before, diff and after). For a PR, attach the `-pair.png`, or `-before` and `-after` side by side in a table.
- `--json` prints to stdout, per page and size: `files` (absolute image paths), `changed` and `total` pixels, and each side's `url`, `status` and `error`.

Then, before reporting:

- Open each `-diff.png` next to its `-pair.png`: the diff shows where pixels changed, the pair shows what changed. Describe every change and say whether it was intended.
- `changed: 0` means the pages are pixel-identical, which proves a refactor changed nothing visible.
- A side with `status` 400 or higher, or an `error`, did not load. Fix the path or the server and run again; a diff against an error page means nothing.
- A layout shift turns everything below it red. Find where the red starts, then compare the area below it in the pair image to see whether anything besides its position changed.

## 4. Clean up

`shot` exits by itself. Stop the live view and the servers you started, then check the ports are free: stopping `npm run dev` can leave the server it started running. Remove the folders (`git worktree remove <dir>`).

## Common mistakes

| Mistake | Fix |
|---|---|
| Copying `--path` values from an example | Use the paths from the site's own links |
| Diffing while a dev server still compiles | Wait for its ready line, then run ccvd |
| Both servers on one port | One free port each |
| `--no-reduced-motion` without a reason, so animations keep the diff from settling | Leave reduced motion on unless the animation itself is under review |
| Reporting the image count, not what changed | Describe each change, using the diff and the pair |

Wersje

W bazie nie ma innych skilli o nazwie ccvd.

Migawka bazy z 13.11.2026 · wersja paczki 7b9428c40f6d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90capture-screenshots
    Robi zrzuty ekranu każdego stanu, rozmiaru i ustawienia jako dowód do pull requesta przy każdej zmianie interfejsu.
  • 100visual-regression
    Wykrywa niezamierzone zmiany wizualne, porównując zrzuty ekranu z wzorcem po każdej zmianie interfejsu webowego przed zgłoszeniem.
  • 100sideshot
    Robi zrzuty ekranu przed i po zmianie w pull requeście, tylko dla zmienionego fragmentu strony, i wstawia tabelę do opisu PR.
  • 95before-and-after
    Dodaje istniejące zrzuty ekranu lub nagrania ekranu do pull requesta na GitHubie jako blok przed i po albo podgląd w opisie PR.
  • 100dev-visual-verdict
    Wykonuje wizualne testy regresji: robi zrzuty przed i po zmianach interfejsu i porównuje je, gdy zmiana może nieoczekiwanie wpłynąć na wygląd komponentów.
  • 100recording
    Nagrywa dowody działania aplikacji webowej: wideo z operacji, zrzuty ekranu i runbook do pull requesta, raportu lub przekazania pracy.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.