hdresearch/vers-agent-services/preview-deploy
Claude Code and agent skill by hdresearch/vers-agent-services
- community
Checking that the SKILL.md file is still in the repository.
Deploy a branch to a preview VM for zero-risk change review. Snapshot infra, clone it, deploy the branch on the clone, share the link. Production untouched. Use for ALL UI changes, feature demos, and PR reviews.
Install
npx vskill@latest install hdresearch/vers-agent-services/preview-deploySKILL.md
The same SKILL.md was published earlier as hdresearch/vers-agent-services/preview-deploy.
Branch-to-Preview Deploy
Every change that has visible output should be demoed on a preview VM before merging. This is the standard review workflow.
When to use
- Any UI change (new tabs, widgets, visual fixes)
- New API endpoints that can be exercised via the dashboard
- Any change where "see it running" is more convincing than "read the diff"
- PR descriptions — include preview links where the change is visible
When NOT to use
- Pure backend refactors with no visible output
- Changes behind auth that can't be shared (note: magic links solve most of this)
- Trivial fixes (typos, comment changes)
The recipe
This is LT work. Delegate it — don't do it as the orchestrator.
1. Snapshot production infra
2. Clone from snapshot
3. Deploy the branch on the clone
Task an LT with:
4. Generate magic link
5. Share with the human
Provide:
- Preview URL:
https://{previewVmId}.vm.vers.sh:3000 - Magic link for browser auth
- Specific page/report link showing the change
- Prime URL for comparison
6. Create share links for visible content
PR reviewers won't have auth tokens. Use share links for any report/page you want to show:
Share links require NO auth — anyone with the link can view.
7. Include in PR description
When opening the PR, include the share link (not the auth-gated URL):
7. After review
- Approved → Deploy branch to production infra, delete preview VM
- Rejected → Delete preview VM. Production untouched. Zero risk.
Key principles
- Production is never touched until approved. The preview VM is disposable.
- Cheap clones. Vers VM snapshots are instant. Don't hesitate to spin up previews.
- Magic links solve auth. Generate one for the reviewer.
- Delete after review. Preview VMs cost nothing idle but clean up anyway.
- LTs do the ops. Snapshot, restore, deploy, restart — all LT work.
Environment
- Infra VM: read from registry or board context
- Auth token: same across clones (inherited from snapshot)
- Service name:
agent-services(systemd unit) - Build:
npm run build(postbuild copies static files) - Port: 3000
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/preview-deploy/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/hdresearch/vers-agent-services/preview-deploy)