w-vercel — Claude Code skill for Vercel build failures
The w-vercel Claude Code skill examines Vercel build failures and fixes the local build. It handles failures on the current branch.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a claude-codeWhat w-vercel does
The skill retrieves build logs for the current branch and checks errors involving TypeScript, ESLint, dependencies, environment variables, imports, and configuration. It uses Vercel MCP when available; otherwise, it can work from logs supplied by the user.
Once it finds the cause, the skill applies a fix and runs the app or package build script from package.json. It stops after a successful local build. It does not deploy or make an unsolicited commit. If behavior or commands change, it calls /w-docs.
What it helps with
- trace a Vercel build failure from its logs
- fix TypeScript or ESLint build errors
- resolve dependency, environment variable, or import errors
- verify the local build after a fix
Example prompts for the agent
- Investigate the Vercel build failure on the current branch and fix the local build.
- Use these build logs to find the cause, then run the project build.
- Check the build configuration and stop once the local build passes.
How to install w-vercel
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a claude-code2Manually: put the files in place
~/.claude/skills/w-vercel/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-vercel/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a codex2Manually: put the files in place
.agents/skills/w-vercel/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a cursor2Manually: put the files in place
.cursor/skills/w-vercel/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-vercel2Manually: put the files in place
.github/skills/w-vercel/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-vercelManually: put the files in place
.devin/skills/w-vercel/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about w-vercel
How do I install w-vercel in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-vercel -a claude-code. The skill file is at ~/.claude/skills/w-vercel/SKILL.md.
What does w-vercel do?
It analyzes build logs for the current branch, fixes the reported cause, and runs the local build script from package.json. It stops at local verification and does not deploy or commit without a request.
How does w-vercel access build logs?
It uses Vercel MCP when available. Otherwise, it can analyze logs supplied by the user.
Source text
SKILL.md · MIT
--- name: w-vercel description: Retrieve Vercel build logs, analyze failures, and fix the local build. disable-model-invocation: true --- Triage a Vercel build failure for the current branch. Use Vercel MCP when available. Fix the local build. Do not deploy. Follow [git publish](references/git-publish.md). 1. Retrieve build logs for the current branch via Vercel MCP (or the user-supplied log). 2. Parse TypeScript, ESLint, missing deps, env, imports, and config errors. 3. Apply the owning fix. Run the app or package build script from `package.json`. Stop at verified local build. No deployment and no unsolicited commit. 4. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills