Writing Guidelines
Review docs and prose against Vercel's 80+ rule writing handbook.
About
Writing Guidelines turns Vercel's writing handbook into an agent skill: 80+ rules covering voice and tone, headings, lists, code samples, typography, placeholders, and AI-workflow disclosure. Ask it to 'review my docs' and it audits for banned words, heading case, code-sample formatting, and structural issues.
It enforces Vercel's voice — direct, active, no 'easy/simple/quick' — which may clash with brand voices that are deliberately warmer or more formal. It reviews prose, not technical accuracy, so factual errors sail through.
What it can do
- Voice and tone auditing
- Heading and structure rules
- Code-sample formatting checks
- Typography enforcement
- AI-disclosure guidance
Setup
npx skills add vercel-labs/agent-skills, or install the single skill via your agent's skill manager. Trigger with 'review my docs' or 'check writing style'.
Prerequisites
An Agent Skills-compatible coding agent; docs or prose to review.
Use cases
Works with
Trust score — 7/10
Scored 7/10 (metrics tier, metrics-v1). Evidence: Verified via vendor site/docs/GitHub and reputable coverage, wave 44 (tools-b); Trending score 74/100 from researcher assessment.
★ 32,353 GitHub stars
Sources
Every fact above was checked against these sources. Where a claim comes from the provider and couldn't be independently verified, the text says so.