web-deploy-verification

Verify web changes are live in production by polling URLs and screenshotting local builds.

3|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/ever-just/agentskills --skill web-deploy-verification-ever-just
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-deploy-verification
Source: https://github.com/ever-just/agentskills/tree/main/skills/web-deploy-verification
Command: npx skills add https://github.com/ever-just/agentskills --skill web-deploy-verification-ever-just

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright-core.

What problem does it solve? A merged PR and a green CI build do not prove a change is actually live — build steps, CDN propagation, and caching layers can silently delay or fail. This Skill closes that gap by confirming changes on the real production URL before you report them as shipped. ## Core Features & Use Cases - Bounded URL polling: Poll a live URL in a background loop for a content marker unique to the new version, with a time ceiling tuned to the platform's typical deploy duration. - Local-build screenshot fallback: When a sandboxed proxy breaks headless-browser navigation to the live URL, build and serve the exact commit locally and screenshot it with Playwright instead. - Pitfall guidance: Avoids false negatives from checking too early, weak content markers, local server port races, proxy stalls, and trusting CI status as proof of deployment. - Use Case: After merging a PR that auto-deploys to Vercel, run the polling loop against the production URL for a string that only exists in the new version, and only tell the user the change shipped once the marker appears. ## Quick Start After merging my PR, verify the new homepage section is actually live on the production URL before reporting it as shipped.

Frequently Asked Questions about web-deploy-verification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a deployment is live after merging a PR?▼

Poll the production URL in a bounded background loop, checking for a string that only exists in the new version such as new copy, a new route, or a new DOM id. Only report the change as shipped once the marker appears, and treat a timeout as a signal to inspect the deploy pipeline.

How long should I wait for a Vercel or Netlify deploy to go live?▼

Deploys typically take 30 seconds to 5 minutes depending on the platform. Use a polling loop with a ceiling generous enough for the platform's typical build time, such as 40 iterations of 20-second sleeps, rather than checking once immediately after merging.

Why does my headless browser hang when navigating to a live URL?▼

Sandboxed environments often set HTTPS_PROXY, which causes headless Chromium navigation to public URLs to stall. Instead of configuring browser proxy settings, build the same commit locally and screenshot it via localhost, since loopback traffic bypasses the proxy entirely.

Does a green CI build mean my change is deployed?▼

No. A successful CI run only proves the code compiles; it says nothing about whether the deploy step ran or ran against the correct commit. Always confirm the change on the real production URL rather than trusting the CI dashboard.

What makes a good content marker for deploy verification?▼

Choose a string unique to the new version, such as new copy, a new route, a new asset filename, or a new DOM id or class. Markers present in both old and new versions, like the site name or nav links, will report success immediately regardless of whether the change deployed.