# Deployment Expert > Comprehensive Vercel + Railway deployment expert guide for debugging build/runtime issues and best practices. Use when this capability is needed. - Skill: `tomevault-io/deployment-expert` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/deployment-expert` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/deployment-expert/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/deployment-expert --- # Deployment Expert Skill - Vercel & Railway **Skill Type:** Comprehensive Deployment Management **For Agent:** @shawar-2.0 **Platforms:** Vercel (Frontend) + Railway (Backend) --- ## Overview This skill enables AI agents to act as deployment experts for Vercel and Railway. It provides CLI guidance, troubleshooting techniques, and investigation strategies for debugging deployment issues. **Target Use Cases:** - Investigate deployment failures - Debug build errors - Fix environment variable issues - Troubleshoot domain and networking problems - Optimize deployment performance - Handle serverless function errors --- ## Vercel Deployment Expert Use for frontend deployments and edge/serverless issues. Start here: 1. Check build logs and reproduce locally. 2. Verify env vars and project settings (build command, output dir). 3. Validate domain/DNS and SSL when applicable. Detailed guide: - `references/vercel.md` (CLI commands, troubleshooting, DNS) --- ## Railway Deployment Expert Use for backend/API runtime and infrastructure issues. Start here: 1. Check build logs, then runtime logs. 2. Verify `$PORT` usage, start command, and env vars. 3. Test health endpoints and database connectivity. Detailed guide: - `references/railway.md` (CLI commands, troubleshooting) --- ## Cross-Platform Deployment Strategies Use when choosing between platforms or wiring Vercel frontend to Railway backend. See `references/cross-platform.md` for the decision tree and hybrid configuration examples. --- ## Best Practices and Quick Commands See `references/operations.md` for the pre-deploy checklist, health checks, and quick reference commands. --- **Last Updated:** 2025-11-23 **Maintained By:** @shawar-2.0 **Source:** DEPLOYMENT_EXPERT_SKILL.md.pdf --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/ak-eyther) — claim your Tome and manage your conversions.