vercel-skills — Claude Code skill: UI review and React work
Pulls in five official Vercel skills: interface review against the Web Interface Guidelines, a writing check, React/Next.js performance, component composition, and View Transitions.
MIT 213 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill vercel-skills -a claude-codeWhat vercel-skills does
The skill is a wrapper. On install it fetches five skills from vercel-labs/agent-skills: web-design-guidelines, writing-guidelines, vercel-react-best-practices, vercel-composition-patterns and vercel-react-view-transitions. Those do the actual work. One audits UI against the Web Interface Guidelines, one checks prose against the Writing Guidelines, one looks at React and Next.js performance, one sets up reusable component composition, one handles transitions through the React View Transition API.
The first two are thin. They download their current rule sets from GitHub every time you run a review, so you need network access while working, not just while installing.
One collision to know about: platform-design-skills also ships a skill named web-design-guidelines. Install both and whichever lands second replaces the first. Keeping two rule sets side by side won't work.
What it helps with
- audit a screen against the Web Interface Guidelines
- check docs against the Writing Guidelines
- track down wasted renders in a React component
- split a wrapper into reusable composition patterns
- add page transitions with the View Transition API
Example prompts for the agent
- Review
app/settings/page.tsxagainst the Web Interface Guidelines and list what breaks. - Refactor this card into composition patterns so other pages can reuse it.
- Add view transitions between the catalogue pages.
How to install vercel-skills
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill vercel-skills -a claude-code2Manually: put the files in place
~/.claude/skills/vercel-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vercel-skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill vercel-skills -a codex2Manually: put the files in place
.agents/skills/vercel-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill vercel-skills -a cursor2Manually: put the files in place
.cursor/skills/vercel-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/vercel-skills2Manually: put the files in place
.github/skills/vercel-skills/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill vercel-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/vercel-skillsManually: put the files in place
.devin/skills/vercel-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill vercel-skills -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 vercel-skills
How do I install vercel-skills in Claude Code?
Run npx skills add podo/design-agent-skills --skill vercel-skills -a claude-code. The skill lands at ~/.claude/skills/vercel-skills/SKILL.md.
What does vercel-skills do?
It installs five Vercel skills covering interface and writing review, React/Next.js performance, component composition and View Transitions.
Does it need internet access?
Yes, while you work. web-design-guidelines and writing-guidelines pull their current rules from GitHub before each review, so offline runs fall flat.
Source text
SKILL.md · MIT
--- name: vercel-skills description: | Official Vercel agent skills for UI review and React work: Web Interface Guidelines compliance review, writing guidelines review, React/Next.js performance, component composition patterns, and React View Transitions. Lives in the vercel-labs/agent-skills collection. triggers: - "Vercel skill" - "web design guidelines" - "React best practices" - "composition patterns" - "Web Interface Guidelines" - "React view transitions" das: category: official-suites upstream: "https://github.com/vercel-labs/agent-skills" version: latest install: false --- # vercel-skills > Catalogue stub — full package: [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** This package installs 5 skills (`web-design-guidelines`, `writing-guidelines`, `vercel-react-best-practices`, `vercel-composition-patterns`, `vercel-react-view-transitions`); checking the first. - Global: `f=~/.agents/skills/web-design-guidelines/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/web-design-guidelines/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `web-design-guidelines`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/vercel-skills ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add vercel-labs/agent-skills --skill web-design-guidelines writing-guidelines vercel-react-best-practices vercel-composition-patterns vercel-react-view-transitions -g -y ``` **Project:** ```bash npx skills add vercel-labs/agent-skills --skill web-design-guidelines writing-guidelines vercel-react-best-practices vercel-composition-patterns vercel-react-view-transitions -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** Network access at use time: web-design-guidelines and writing-guidelines are thin skills that fetch their current rules from vercel-labs/web-interface-guidelines and vercel-labs/writing-guidelines on GitHub before each review - **License:** no LICENSE file in the repository - **Name collision:** `web-design-guidelines` is also written by `platform-design-skills` (its install or its catalogue pointer); installing both overwrites the earlier one. <!-- das:install:end --> ## Invoke after install - `web-design-guidelines` — "web design guidelines", "UI review" - `writing-guidelines` — "review my docs", "writing style audit" - `vercel-react-best-practices` — "React performance", "Next.js optimization" - `vercel-composition-patterns` — "composition patterns", "reusable React patterns" - `vercel-react-view-transitions` — "React view transitions", "page transition animation" ## What it does Vercel's official skill collection, narrowed to the design-relevant five: reviews UI code against the Web Interface Guidelines, reviews prose against the Writing Guidelines (both fetch their current rules from GitHub at use time), optimizes React/Next.js performance, establishes reusable component composition patterns, and guides smooth native-feeling transitions with the React View Transition API. The repo also holds Vercel deployment, CLI, optimization and React Native skills that are not catalogued here. For accessible, composable component authoring, see `building-components` (a separate Vercel repo). ## When NOT to use - Review of platform-specific Apple or Android UI guidelines — use `platform-design-skills` (note it also installs a different skill named `web-design-guidelines`, so installing both overwrites one) - Component library setup rather than review — use `shadcn-ui`
© podo · MIT · podo/design-agent-skills