Back to the catalog

before-and-after

vercel-labs/before-and-after · skills.sh

Open source Repository Open in the app JSON README (API)

About

Skill publicada por vercel-labs/before-and-after no skills.sh. Instale com: npx skills add vercel-labs/before-and-after@before-and-after

Details

Kind
Agent skills
Topic
Cloud & DevOps
Publisher
vercel-labs
Origin
skillssh
Category
ferramentas
Stars
338
Forks
12
Open pull requests
3
Last push
2026-09-02T21:10:48Z
Repository state
ativo
Language
TypeScript
License
NOASSERTION
Added
2026-08-30 15:22:21
Updated
2026-09-08 15:04:42
Origin id
vercel-labs/before-and-after/before-and-after

README

# before-and-after

An agent skill that attaches existing screenshots and screen recordings to a GitHub pull request as a before/after block.

Browser work belongs to [agent-browser](https://agentbrowser.dev) and its bundled skills. Uploads belong to `gh --attach`. This skill owns the workflow between them and one dependency-free script that formats media and replaces a marked block in the PR body.

![before-and-after](https://jm.sv/before-and-after/opengraph-image.png)

## Install

```bash
npx skills add vercel-labs/before-and-after#main
```

Requires `agent-browser` and GitHub CLI 2.99+ (for `gh --attach`).

## What it produces

- Side-by-side image tables for before/after pairs, with equal-height full-page captures so tops align.
- `Preview` blocks for after-only media.
- Own-line videos that GitHub renders as players, and a two-step HTML video table once attachment URLs exist.
- Idempotent replacement of one `<!-- before-and-after:start/end -->` block; the rest of the PR description is untouched.
- Placement guidance that keeps real visual proof near the top and ahead of clearly labeled supplemental demos.

See `skill/SKILL.md` for the workflow.

## Verification

Each layer answers one question. Details in `VERIFICATION.md`.

| Command | Runs | Proves | Needs |
|---|---|---|---|
| `pnpm test` | CI, every PR | `format.mjs` markup and marker replacement, including error paths | nothing |
| `pnpm verify:skill` | CI, every PR | package ships only `skill/`; every `--flag` in SKILL.md exists in `format.mjs` and vice versa | `npm` |
| `pnpm verify:local` | CI, every PR | with the installed agent-browser: the padding recipe yields equal-height pairs, the recorder produces real frames at the stated fps, `record start` drops headers as SKILL.md warns | `agent-browser`, `ffprobe` |
| `pnpm verify:github` | CI weekly and on non-fork PRs once `FIXTURE_GITHUB_TOKEN` is set; local otherwise | GitHub renders what SKILL.md claims (cell mapping, top alignment, playable video) and the exact `gh pr edit --attach` publish sequence works, twice, preserving prose | `gh`, `agent-browser`, fixture PR |
| `pnpm verify:agent` | local, before releases | Claude Code following SKILL.md unassisted produces a correct PR | `claude`, ~$2 |

`pnpm verify` runs the first three.

## Scope

Does not wrap `agent-browser`, capture URLs, manage Vercel authentication, convert video, or host media.

More