← Back to list

vercel-debug
by yahsan2
⭐ 0🍴 0📅 Jan 5, 2026
SKILL.md
name: vercel-debug description: Investigate Vercel deployment errors using Vercel CLI. Use when user shares a Vercel deployment error, build failure, or deployment URL that needs debugging.
Vercel Deployment Debugging
Workflow
1. Check authentication
vercel whoami
If error "No credentials found", prompt user to run vercel login in their terminal (interactive).
2. List recent deployments
vercel list <project-name> --scope <team-name>
Find the failing deployment URL (status: Error or Building).
3. Get build logs
vercel inspect <deployment-url> --logs --scope <team-name>
Add --wait to wait for in-progress builds:
vercel inspect <deployment-url> --logs --scope <team-name> --wait
4. Common errors
| Error | Cause | Fix |
|---|---|---|
| Mixed Routing Properties | routes and rewrites mixed in vercel.json | Use only rewrites (new format) |
| Cannot find module | Package not built before dependent | Add to build command or use turbo |
| Build Command > 256 chars | Command too long | Use pnpm build with turbo/nx |
5. Get deployment info (without logs)
vercel inspect <deployment-url> --scope <team-name>
Score
Total Score
50/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
○LICENSE
ライセンスが設定されている
0/10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon