deployment-token-rotation

Rotate deployment tokens and secrets across Vercel and Railway environments.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/habrahgithub/node-backend-starter --skill deployment-token-rotation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployment-token-rotation
Source: https://github.com/habrahgithub/node-backend-starter/tree/main/.codex/skills/deployment-token-rotation
Command: npx skills add https://github.com/habrahgithub/node-backend-starter --skill deployment-token-rotation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, railway, vercel, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Prevents prolonged exposure of compromised or expired deployment secrets by providing a controlled, auditable process to rotate environment tokens across hosted platforms.

Core Features & Use Cases

  • Dry-run first, explicit apply: Scripts default to dry-run and require an explicit --apply to execute changes.
  • Multi-provider support: Handles Vercel environment variable rotation and Railway service or shared variable updates.
  • Verification and rollback guidance: Includes verification steps (health checks, integration calls, log monitoring) and clear rollback instructions using the previous known-good value.
  • Use Case: Replace a leaked API token for a payment gateway in production without disrupting service by previewing the change, verifying, then applying.

Quick Start

Ask the agent to run a dry-run rotation for the PAYMENT_GATEWAY_API_TOKEN on Vercel or Railway, confirm the preview, then apply the change when ready.

Frequently Asked Questions about deployment-token-rotation

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

FAQPage Schema
How do I rotate environment variables and deployment tokens on Vercel and Railway?

You rotate deployment tokens by executing a dry-run preview first, then explicitly applying changes via the Vercel and Railway CLIs using new secret values supplied through environment variables and jq-based JSON patches.

What is the safest way to update a leaked API token in production environments?

The safest way to update a leaked API token is using a controlled, auditable rotation process that defaults to dry-run previews, requires explicit confirmation to apply changes, and includes verification steps and rollback guidance using the previous known-good value.

Can I preview secret rotation changes before applying them to my Vercel or Railway environments?

Yes, you can preview secret rotation changes. The rotation scripts default to a dry-run mode that previews the changes, requiring an explicit --apply flag to execute the updates across your Vercel and Railway environments.

Do I need to install jq and CLIs to rotate deployment secrets across hosting platforms?

Yes, you need jq, the Vercel CLI, and the Railway CLI installed. These tools are required to apply the JSON patches and execute the environment variable updates during the token rotation process.

How do I handle scheduled key rollovers for shared service variables in development contexts?

You handle scheduled key rollovers by running the rotation scripts against your development context, previewing the shared variable updates in a dry-run, and applying the changes with the Railway CLI when ready.

What should I do if token rotation breaks my application integration?

If token rotation breaks your application, you should follow the rollback guidance to restore the previous known-good value, then monitor health checks, integration calls, and logs to verify service stability.