Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

pr-screenshots

/pr-screenshots

Robi zrzuty ekranu przed i po zmianie wizualnej w grze, na desktopie i mobile, i dołącza je do opisu pull requestu.

Repozytorium
whetstorm-art ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.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
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.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

Robi zrzuty ekranu przed i po zmianie wizualnej w grze, na desktopie i mobile, i dołącza je do opisu pull requestu.

Oryginalny opis (EN)

Capture before/after screenshots for a World of ClaudeCraft PR (desktop and mobile), commit them under docs/screenshots, and reference them from the PR body. Use when a change is visual (render, HUD, CSS, content models, windows), when the PR template's screenshot requirement applies, or when asked to screenshot the game for a review or comparison. Covers the change-aware capture tooling, the before/after protocol, and the known puppeteer/CDP traps.

Jak działa

  1. 1. Use the change-aware tooling first
  2. 2. Before/after protocol
  3. 3. Traps that have burned sessions before
Sekcje z nagłówków SKILL.md, w oryginale · 68 linii, 532 słów
Podgląd SKILL.md
---
name: pr-screenshots
description: Capture before/after screenshots for a World of ClaudeCraft PR (desktop and mobile), commit them under docs/screenshots, and reference them from the PR body. Use when a change is visual (render, HUD, CSS, content models, windows), when the PR template's screenshot requirement applies, or when asked to screenshot the game for a review or comparison. Covers the change-aware capture tooling, the before/after protocol, and the known puppeteer/CDP traps.
user-invocable: true
---

# PR screenshots

The repo rule (root `CLAUDE.md`): a visual change ships with before/after screenshots,
desktop and mobile where relevant, committed under `docs/screenshots/` and referenced from
the PR body. This skill is the capture recipe.

## 1. Use the change-aware tooling first

With `npm run dev` running (serves :5173):

```
git diff <base>...HEAD > /tmp/pr.diff
BROWSER_PATH=/path/to/chrome DIFF_FILE=/tmp/pr.diff SHOTS_DIR=pr-shots \
  node scripts/pr_screenshots.mjs
```

`scripts/pr_screenshots.mjs` drives the OFFLINE client through the shared entry flow
(`scripts/enter_offline_game.mjs`, which handles the intro overlay that otherwise hides
`#ui`) and decides WHAT to shoot from the diff: specific windows via the target table,
the generic desktop/mobile HUD for broad visual changes, and nothing for non-visual diffs.

**Adding coverage is one entry in `scripts/pr_shot_targets.mjs`, not a new script.** Each
target maps changed-path substrings to a bring-up recipe (driving `window.__game`) and a
clip region. Only write a bespoke `scripts/<thing>_shot.mjs` when the flow genuinely cannot
be a target entry (for example an online-only or multi-client scene).

**Standing capture rule (maintainer preference): every capture rig seeds the LOWEST
graphics preset before the app boots.** Seed it the way the existing rigs seed presets,
via `page.evaluateOnNewDocument` writing `localStorage` `woc_settings` with
`{ graphicsPreset: 1 }` before `page.goto`. `scripts/climb_stall_shot.mjs` shows the
seeding MECHANISM, but copy only the shape: that rig deliberately seeds a high profile
(preset 5, the Advanced expert profile whose sub-dials it also seeds; the ladder in
`src/ui/options_view.ts` tops out at the Insane preset above Ultra) because its purpose
is a graphics shot. The default preset is not the lowest either (`src/game/settings.ts`
pins the range), so an unseeded rig is NOT lowest. The one
exception: shots whose PURPOSE is a graphics comparison (preset ladders, VFX quality,
shadow tiers) keep the preset the comparison needs.

## 2. Before/after protocol

1. Capture AFTER on your branch.
2. `git stash` or check out the base commit in a scratch worktree, capture BEFORE with the
   same script and targets, restore.
3. The Vite dev client picks up source changes live, but `npm run server` bundles at START:
   after any branch flip, restart the server before online captures or you will shoot a
   stale bundle.
4. Move the keepers to `docs/screenshots/<slug>/before-*.png` / `after-*.png`, commit them,
   and reference them from the PR body with repo-relative links.
5. For screenshots in a REVIEW COMMENT on someone else's PR: GitHub `user-attachments`
   upload URLs only work from the web UI. Push the PNGs to a gist and embed the gist's raw
   URLs instead.

## 3. Traps that have burned sessions before

- **Viewport sizing:** after `page.setViewport`, `window.innerWidth` can be stale. Use raw
  CDP `Emulation.setDeviceMetricsOverride` for exact metrics, and remember CDP
  `Page.captureScreenshot` shoots the WINDOW, not the viewport: clip explicitly.
- **`page.evaluate` under tsx:** tsx's keepNames injects `__name` and breaks nested
  functions inside evaluate callbacks. Pass string-form bodies to
  `evaluateOnNewDocument`/`evaluate` when a script runs under tsx.
- **`window.__game` proves reachability only to the window boundary.** For a claim about
  real behavior, drive the actual bound key or click, not the debug hook.
- **Mobile is landscape-only in-game** on the web client: use landscape device metrics for
  mobile HUD shots (the shell/guide/admin pages allow portrait).
- **Dev commands:** captures that teleport, level, or grant items need a server started
  with `ALLOW_DEV_COMMANDS=1` (dev only, never production).

Wersje

RepozytoriumWynikLicencja
Ta strona · rowdybard/whetstorm-art100MIT
cardstack/boxel100MIT
kylefritz/pr-screenshot-skill95MIT

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

Pobrania w ostatnich 30 dniach: 1 · ranking

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

Podobne skille

  • 100screenshot
    Wykonuje zrzuty ekranu działającej gry przez godot-e2e do weryfikacji wizualnej i przygotowania referencyjnego reference.png.
  • 90capture-screenshots
    Robi zrzuty ekranu każdego stanu, rozmiaru i ustawienia jako dowód do pull requesta przy każdej zmianie interfejsu.
  • 100before-after
    Dowodzi zmiany wizualnej, robiąc zrzuty tego samego ekranu na gałęzi bazowej i własnej, i dołącza oba do pull requestu lub merge requestu.
  • 100axiom-validate-screenshots
    Weryfikuje zrzuty ekranu do App Store: wymiary i zawartość przed zgłoszeniem.
  • 90Screenshot
    Wykonuje, sprawdza i porównuje zrzuty ekranu okien, stron, symulatorów i przebiegów CI, z ustalonym rozmiarem widoku i wyciszeniem animacji.
  • 100take-doc-screenshots
    Robi zrzuty ekranu działającej aplikacji pgconsole do dokumentacji i wstawia je do plików .mdx.

Uwagi i zgłoszenia

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