# Deploy Preview

> Deploy a preview branch to the staging environment for review. Use when a feature branch is ready for visual review, when someone asks to "deploy this for review", or before opening a PR.

- **Type:** Skill
- **Install:** `agentstack add skill-zakelfassi-skills-driven-development-deploy-preview`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zakelfassi](https://agentstack.voostack.com/s/zakelfassi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zakelfassi](https://github.com/zakelfassi)
- **Source:** https://github.com/zakelfassi/skills-driven-development/tree/main/examples/webapp-starter/skills/deploy-preview
- **Website:** https://zakelfassi.github.io/skills-driven-development/

## Install

```sh
agentstack add skill-zakelfassi-skills-driven-development-deploy-preview
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Deploy Preview

Deploy the current branch to a preview URL for review before merging.

## Inputs
- Branch name (defaults to current branch)
- Environment (defaults to `staging`)

## Steps

1. **Verify branch is clean**
   ```bash
   git status --porcelain
   ```
   If dirty, commit or stash before proceeding.

2. **Run tests locally**
   ```bash
   npm test
   ```
   Do not deploy if tests fail.

3. **Push to remote**
   ```bash
   git push origin HEAD
   ```

4. **Trigger preview deploy**
   ```bash
   scripts/deploy-preview.sh
   ```
   This builds, uploads, and returns a preview URL.

5. **Verify the preview**
   - Open the preview URL
   - Check: page loads, no console errors, key feature works
   - If broken: fix locally, re-push, re-deploy

6. **Share the preview URL**
   - Post in the PR description
   - Or share in the team channel

## Conventions
- Preview URLs follow the pattern: `preview-{branch}.staging.example.com`
- Preview deploys expire after 7 days
- Only one preview per branch (re-deploying replaces the previous)

## Edge Cases
- **Branch name has slashes:** The deploy script sanitizes `/` to `-`
- **Large assets:** Preview deploys skip video files >50MB
- **Environment variables:** Preview uses staging env vars, not production

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zakelfassi](https://github.com/zakelfassi)
- **Source:** [zakelfassi/skills-driven-development](https://github.com/zakelfassi/skills-driven-development)
- **License:** MIT
- **Homepage:** https://zakelfassi.github.io/skills-driven-development/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zakelfassi-skills-driven-development-deploy-preview
- Seller: https://agentstack.voostack.com/s/zakelfassi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
