Preview Deployments Skill

Name: Preview Deployments Skill
Author: zeke

zeke/preview-deployments-skill

15 repo stars
Updated June 29, 2026
zeke/preview-deployments-skill

Preview Deployments Skill is an open-source Claude Code agent skill by Zeke Sikelianos that adds pull-request preview deployments to an existing Cloudflare Workers app. It generates a GitHub Actions workflow that deploys

About

Preview Deployments Skill teaches a coding agent to add pull-request preview deployments to an existing Cloudflare Workers app. It inspects the repo (package.json, wrangler.jsonc, existing workflows and Cloudflare bindings like D1, R2, KV, Queues, Durable Objects), then generates a GitHub Actions workflow that deploys a deterministic per-PR Worker at https://<app>-pr-<number>.<subdomain>.workers.dev. Status is published through the GitHub Deployments API (in_progress / success / failure / inactive) rather than sticky PR comments, with per-PR concurrency, transient environments, and stale-run guards. It supports three resource strategies - shared production, empty per-PR, or seeded per-PR resources - and tears previews down on PR close. Install with npx skills add zeke/preview-deployments-skill.

Generates a GitHub Actions workflow for per-PR Cloudflare Workers preview deployments at deterministic <app>-pr-<number>
Reports preview status via the GitHub Deployments API (in_progress/success/failure/inactive), not sticky PR comments
Detects Cloudflare bindings (D1, R2, KV, Queues, Durable Objects, Workers AI, Vectorize, Hyperdrive) before editing
Three resource strategies: shared production, empty per-PR, or seeded per-PR resources
Auto-teardown on PR close plus stale-run guards so a superseded commit never advertises a live preview

Preview Deployments Skill by the numbers

Data as of Jul 18, 2026 (Skillselion catalog sync)

npx skills add https://github.com/zeke/preview-deployments-skill --skill preview-deployments-skill

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/zeke/preview-deployments-skill.svg)](https://skillselion.com/skills/zeke/preview-deployments-skill)

repo stars	★ 15
Last updated	June 29, 2026
Repository	zeke/preview-deployments-skill ↗

What it does

Add per-PR preview deployments to a Cloudflare Workers app so every pull request gets a live ephemeral preview URL with deployment status, torn down automatically on PR close.

Who is it for?

Teams shipping a Cloudflare Workers app on GitHub who want every pull request to get a live preview URL with proper deployment status and automatic teardown.

Skip if: Apps not deployed to Cloudflare Workers, or teams that rely on PR/sticky comments for preview status instead of the GitHub Deployments API.

What you get

Every pull request gets a deterministic live preview URL with proper GitHub deployment status, the right resource strategy for your data, and automatic teardown on close - generated by the agent after inspecting your rep

By the numbers

Deploys one ephemeral Worker per pull request
Triggers on 5 pull_request event types (opened, reopened, synchronize, ready_for_review, closed)
Offers 3 resource strategies (shared, empty per-PR, seeded per-PR)

Files

SKILL.mdMarkdownGitHub ↗

Add Cloudflare Workers preview deployments to existing GitHub apps using GitHub Actions, Wrangler, gh secrets, and the GitHub Deployments API. Use when asked to add per-PR preview deployments, ephemeral Workers previews, preview URLs, GitHub deployment statuses, Cloudflare preview environments, or teardown on PR close. Triggers on pull_request events (opened/reopened/synchronize/ready_for_review/closed), uses per-PR concurrency, contents:read + deployments:write permissions, deterministic <app>-pr-<number> names, and the GitHub Deployments API for PR UI status with environment_url, log_url, and transient_environment:true. Supports shared production, empty per-PR, or seeded per-PR resource strategies.