preview-environments-builder — скилл для Claude Code
Скилл preview-environments-builder генерирует пайплайны временных окружений для каждого пулл-реквеста с автоматическим развёртыванием, уникальным адресом и удалением ресурсов после закрытия PR.
MIT 250 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-codeЧто делает preview-environments-builder
Скилл помогает настроить изолированные тестовые стенды под каждый пулл-реквест. Внутри содержатся готовые конфигурации GitHub Actions под Vercel и связку Docker с Kubernetes. Сценарии создают отдельное окружение, публикуют ссылку в комментарии к пулл-реквесту и удаляют ресурсы сразу после его закрытия.
В инструкции заложены правила генерации адресов, наполнение тестовой базы данных через psql и вызов скриптов вроде db:seed. Без корректных секретов репозитория вроде VERCEL_TOKEN или настроенного доступа к кластеру пайплайн сразу завершится ошибкой.
Какие задачи решает
- развернуть изолированное превью-окружение для пулл-реквеста
- настроить автоматическую отправку ссылки на стенд в комментарии PR
- настроить удаление ресурсов и пространств имён после закрытия пулл-реквеста
- подготовить тестовую базу данных для временного контура
Примеры запросов агенту
- Настрой GitHub Actions для деплоя превью в Vercel на каждый PR
- Сделай воркфлоу развёртывания временного стенда в Kubernetes с удалением после закрытия PR
- Добавь шаг создания и наполнения тестовой базы данных для превью-окружения
Как установить preview-environments-builder
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/preview-environments-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/preview-environments-builder/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill preview-environments-builder -a codex2Вручную: положить файлы
.agents/skills/preview-environments-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill preview-environments-builder -a cursor2Вручную: положить файлы
.cursor/skills/preview-environments-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills ci-cd/preview-environments-builder/SKILL.md2Вручную: положить файлы
.github/skills/preview-environments-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill preview-environments-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path ci-cd/preview-environments-builderВручную: положить файлы
.devin/skills/preview-environments-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill preview-environments-builder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о preview-environments-builder
Как установить preview-environments-builder в Claude Code?
Выполните команду npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-code.
Что делает preview-environments-builder?
Он предоставляет шаблоны GitHub Actions для запуска временных тестовых окружений на Vercel или Kubernetes под каждый пулл-реквест.
Как происходит очистка ресурсов после завершения работы?
Сценарий отслеживает закрытие пулл-реквеста и удаляет деплоймент в Vercel либо очищает пространство имён в Kubernetes.
Исходный текст
SKILL.md · MIT
---
name: preview-environments-builder
description: Creates ephemeral preview deployments for each pull request with automatic deployment, unique URLs, and cleanup on PR close. Use for "preview deployments", "PR environments", "ephemeral environments", or "review apps".
---
# Preview Environments Builder
Deploy isolated preview environments for every pull request.
## Vercel Preview Deployment
```yaml
# .github/workflows/preview.yml
name: Preview Deployment
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
deploy-preview:
runs-on: ubuntu-latest
environment:
name: preview-${{ github.event.pull_request.number }}
url: ${{ steps.deploy.outputs.url }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
- run: npm ci
- run: npm run build
- name: Deploy to Vercel
id: deploy
uses: amondnet/vercel-action@v25
with:
vercel-token: ${{ secrets.VERCEL_TOKEN }}
vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
scope: ${{ secrets.VERCEL_ORG_ID }}
alias-domains: pr-${{ github.event.pull_request.number }}.myapp.dev
- name: Comment PR
uses: actions/github-script@v7
with:
script: |
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: `✅ Preview deployed!\n\n🔗 **URL:** ${{ steps.deploy.outputs.url }}\n\nCommit: ${context.sha.substring(0, 7)}`
})
```
## Docker-based Preview
```yaml
preview:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Build Docker image
run: |
docker build -t myapp:pr-${{ github.event.pull_request.number }} .
- name: Deploy to Kubernetes
run: |
kubectl create namespace pr-${{ github.event.pull_request.number }} || true
kubectl apply -f k8s/preview.yml \
--namespace pr-${{ github.event.pull_request.number }}
kubectl set image deployment/myapp \
myapp=myapp:pr-${{ github.event.pull_request.number }} \
--namespace pr-${{ github.event.pull_request.number }}
- name: Get preview URL
id: url
run: |
URL=$(kubectl get ingress myapp \
--namespace pr-${{ github.event.pull_request.number }} \
-o jsonpath='{.status.loadBalancer.ingress[0].hostname}')
echo "url=https://pr-${{ github.event.pull_request.number }}.preview.myapp.com" >> $GITHUB_OUTPUT
- name: Comment PR
uses: actions/github-script@v7
with:
script: |
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: `🚀 Preview deployed to: ${{ steps.url.outputs.url }}`
})
```
## Cleanup on PR Close
```yaml
# .github/workflows/cleanup-preview.yml
name: Cleanup Preview
on:
pull_request:
types: [closed]
jobs:
cleanup:
runs-on: ubuntu-latest
steps:
- name: Delete Vercel deployment
uses: actions/github-script@v7
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
script: |
const deployments = await github.rest.repos.listDeployments({
owner: context.repo.owner,
repo: context.repo.repo,
environment: `preview-${context.issue.number}`
});
for (const deployment of deployments.data) {
await github.rest.repos.createDeploymentStatus({
owner: context.repo.owner,
repo: context.repo.repo,
deployment_id: deployment.id,
state: 'inactive'
});
await github.rest.repos.deleteDeployment({
owner: context.repo.owner,
repo: context.repo.repo,
deployment_id: deployment.id
});
}
- name: Cleanup Kubernetes namespace
run: |
kubectl delete namespace pr-${{ github.event.pull_request.number }} --ignore-not-found=true
```
## Environment Naming
```yaml
# Consistent naming pattern
environment:
name: preview-pr-${{ github.event.pull_request.number }}
url: https://pr-${{ github.event.pull_request.number }}.preview.myapp.com
```
## Database Seeding
```yaml
- name: Setup preview database
run: |
# Create database
psql -c "CREATE DATABASE preview_pr_${{ github.event.pull_request.number }};"
# Seed with test data
npm run db:seed -- --database=preview_pr_${{ github.event.pull_request.number }}
env:
DATABASE_URL: ${{ secrets.PREVIEW_DB_URL }}
```
## Best Practices
1. **Unique URLs**: pr-{number}.preview.domain.com
2. **Auto cleanup**: Delete on PR close
3. **Comment on PR**: Link to preview
4. **Environment protection**: Require approval
5. **Resource limits**: Prevent abuse
6. **TTL**: Auto-delete after 7 days
7. **Secrets management**: Use preview-specific secrets
## Output Checklist
- [ ] Preview deployment workflow
- [ ] Unique URL generation
- [ ] PR comment with link
- [ ] Cleanup workflow on close
- [ ] Environment naming strategy
- [ ] Database seeding (if needed)
- [ ] Resource limits configured
© patricio0312rev · MIT · patricio0312rev/skills