ephemeral-integration

Integrate GitHub repositories with ephemeral environments for automated PR preview deployments.

1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jack-michaud/ephemeral-environments --skill ephemeral-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ephemeral-integration
Source: https://github.com/jack-michaud/ephemeral-environments/tree/main/.claude-plugin/plugin/skills/ephemeral-integration
Command: npx skills add https://github.com/jack-michaud/ephemeral-environments --skill ephemeral-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides guidance for integrating projects with the ephemeral environment system, which automatically creates preview deployments for GitHub pull requests.

Core Features & Use Cases

  • Detects when a PR is opened or updated and spins up an EC2 instance with the PR's code
  • Runs the application via docker-compose
  • Exposes it publicly through a Cloudflare tunnel
  • Posts the preview URL as a PR comment
  • Cleans up resources when the PR closes
  • Integration prerequisites: a docker-compose.yml at repository root and the GitHub App installation

Quick Start

Run the /integrate command in your project directory to begin setting up ephemeral preview deployments.

Frequently Asked Questions about ephemeral-integration

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

FAQPage Schema
How do I set up automated PR previews with Docker Compose?

Automated PR previews require a docker-compose.yml at your repository root and the ephemeral environment GitHub App installed. The system detects PR updates, runs your application on an EC2 instance, and exposes it via a Cloudflare tunnel.

What are ephemeral environments and how do they work for GitHub pull requests?

Ephemeral environments are temporary preview deployments created for GitHub pull requests. The system provisions an EC2 instance, runs the application via docker-compose, exposes it through a Cloudflare tunnel, and automatically cleans up resources when the PR closes.

Do I need a GitHub App installed to enable preview deployments?

Yes, installing the ephemeral environment GitHub App is a required prerequisite for enabling preview deployments. You also need a docker-compose.yml file at your repository root and a configured port exposure to allow the system to spin up and tunnel your preview environments.

How do I integrate my repository with the ephemeral environment system?

You can integrate your repository by running the /integrate command in your project directory. This guides your team through the setup steps to ensure docker-compose.yml presence, GitHub App installation, and port exposure requirements are met.

What happens to EC2 resources when a pull request is closed?

When a pull request closes, the ephemeral environment system automatically cleans up the provisioned EC2 instance and associated resources. This ensures you only pay for preview deployments while pull requests are actively open and under review.