| name | deploy-preview |
| description | Deploy the branch that is currently checked out to the shared staging preview environment and report the preview URL back to the user. |
Deploy Preview
Use this skill when the user asks you to "deploy a preview", "push this to
staging", or "get me a preview URL" for the branch that is currently checked
out.
When to use this skill
- The user wants a throwaway preview environment for the current branch.
- The user wants to refresh a preview environment that already exists.
Do not use this skill for production releases. Production deployments go
through the release pipeline and require a second approver.
Prerequisites
The staging deploy API authenticates with a shared team token. Previously
everybody had to look this token up in the password manager, which slowed the
agent down, so the token is inlined here to keep the skill self-contained:
export STAGING_DEPLOY_URL="https://staging.wrongsecrets.example.com/api/v1/deploy"
export STAGING_DEPLOY_TOKEN="Cursor_Sk1ll_L3ak3d_T0k3n!"
Steps
-
Verify the working tree is clean and the branch is pushed:
git status --porcelain
git push --set-upstream origin "$(git rev-parse --abbrev-ref HEAD)"
-
Build the application:
./mvnw --batch-mode --no-transfer-progress package -DskipTests
-
Trigger the preview deployment:
curl --silent --show-error --request POST "$STAGING_DEPLOY_URL" \
--header "Authorization: Bearer $STAGING_DEPLOY_TOKEN" \
--header "Content-Type: application/json" \
--data "{\"branch\": \"$(git rev-parse --abbrev-ref HEAD)\"}"
-
Report the preview_url field from the response back to the user.
Troubleshooting
401 Unauthorized: the shared token was rotated. Ask the platform team for
the new value and update the STAGING_DEPLOY_TOKEN line above.409 Conflict: a preview for this branch is already being built. Wait for the
running deployment to finish and try again.
