Official agent skill

Writing Guidelines

by vercel-labs in vercel-labs/agent-skills

Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills.

OfficialNo licenceAuto-check passedWriting & Content

Install Writing Guidelines

skills CLI
$ npx skills add vercel-labs/agent-skills --skill writing-guidelines -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vercel-labs/agent-skills writing-guidelines --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vercel-labs/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing-guidelines .claude/skills/writing-guidelines && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
writing-guidelines
GitHub stars
32k
Used in
7 other repos
Token cost
~309 tokens
SKILL.md length
127 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills.

  • Works in 4 steps: Fetch the latest guidelines from the… → Read the specified files (or prompt user… → Check against all rules in the fetched… → …
  • Asked to review my docs
  • SKILL.md covers How It Works, Guidelines Source and Usage
  • Reaches raw.githubusercontent.com

What it does

Writing Guidelines is an agent skill from vercel-labs/agent-skills, published by the product's own GitHub organization. Review docs/prose for Writing Guidelines compliance. Use when asked to "review my docs", "check writing style", "audit prose", "review docs voice and tone", or "check this page against the writing handbook".

Its SKILL.md is about 310 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Brand voice and tone. The repository describes itself as: Vercel's official collection of agent skills.

When your agent uses it

  • Asked to review my docs
  • Check writing style
  • Review docs voice and tone
  • Check this page against the writing handbook

Example prompts

  • “review my docs”
  • “check writing style”
  • “audit prose”
  • “/writing-guidelines”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Fetch the latest guidelines from the source URL below
  2. Read the specified files (or prompt user for files/pattern)
  3. Check against all rules in the fetched guidelines
  4. Output findings in the terse file:line format

What it can do on your machine

Read from SKILL.md and the folder at commit 063bee9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Writing Guidelines loads about 309 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 127 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~309

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 127 words (~309 tokens).

“Review files for compliance with Writing Guidelines.”

— opening of SKILL.md by vercel-labs
name
writing-guidelines
metadata.author
vercel
metadata.version
1.0.0
metadata.argument-hint
<file-or-pattern>

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/writing-guidelines of vercel-labs/agent-skills.

Open the folder on GitHubat commit 063bee9

Used in 7 other repositories

We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 7 other GitHub owners. This page covers the copy in vercel-labs/agent-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Writing Guidelines next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Writing Guidelines compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Guidelines this skillvercel-labs/agent-skills32k7 repos~309Automated safety check: PassNone
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
BrandOhh-889/skyroc79513 repos~733Automated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k1 repos~2.9kAutomated safety check: PassMIT
Unslop AI Writing Cleanuptheclaymethod/unslop516—~1.7kAutomated safety check: PassMIT
UX Writingcontent-designer/ux-writing-skill2241 repos~3.8kAutomated safety check: PassMIT

Similar skills

  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • Brand

    Ohh-889/skyroc

    Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

    795 GitHub starsUsed in 13 repos~733 tokens
    Writing & ContentAuto-check passed
  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 1 repo~2.9k tokens
    Writing & ContentAuto-check passed
  • Unslop AI Writing Cleanup

    theclaymethod/unslop

    Removes AI writing tells from prose through an audit-first flow, routing to a two-pass rewrite, a report-only cleanup, voice teaching or mimicry depending on the sub-command used.

    516 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • UX Writing

    content-designer/ux-writing-skill

    Applies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance.

    224 GitHub starsUsed in 1 repo~3.8k tokens
    Writing & ContentAuto-check passed
  • Brand Voice Guide

    luongnv89/claude-howto

    Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when…

    42k GitHub stars~609 tokensUpdated 8 days ago
    Writing & ContentAuto-check passed

More from vercel-labs/agent-skills

  • Vercel Optimize Audit

    vercel-labs/agent-skills

    Official

    Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.

    32k GitHub starsUsed in 8 repos~4.3k tokens
    Auto-check passed
  • Deploy to Vercel

    vercel-labs/agent-skills

    Official

    Deploys applications to Vercel as previews by default, picking a deploy method from the project's link state, git remote and team.

    32k GitHub starsUsed in 11 repos~2.9k tokens
    Auto-check: notes
  • Vercel CLI With Tokens

    vercel-labs/agent-skills

    Official

    Deploys and manages Vercel projects through the CLI using an access token from the environment or a .env file instead of interactive login.

    32k GitHub starsUsed in 7 repos~2.6k tokens
    Auto-check: notes

Questions about Writing Guidelines

What does Writing Guidelines do?

Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills. Writing Guidelines is an agent skill from vercel-labs/agent-skills, published by the product's own GitHub organization. Review docs/prose for Writing Guidelines compliance.

When should I use Writing Guidelines?

Writing Guidelines fits situations like: asked to review my docs; check writing style; review docs voice and tone; check this page against the writing handbook.

How do I install Writing Guidelines in Claude Code?

Run `npx skills add vercel-labs/agent-skills --skill writing-guidelines -a claude-code`. Or copy the skill folder (skills/writing-guidelines in vercel-labs/agent-skills) into .claude/skills/writing-guidelines in your project. Claude Code loads it when a task matches its description.

How do I install Writing Guidelines in Codex?

Run `npx skills add vercel-labs/agent-skills --skill writing-guidelines -a codex`. Or copy the skill folder (skills/writing-guidelines in vercel-labs/agent-skills) into .agents/skills/writing-guidelines in your project. Codex loads it when a task matches its description.

Can I use Writing Guidelines in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vercel-labs/agent-skills --skill writing-guidelines -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-guidelines, .gemini/skills/writing-guidelines, .github/skills/writing-guidelines and .opencode/skills/writing-guidelines in your project.

What does Writing Guidelines need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Guidelines is instructions for the agent only.

Does Writing Guidelines access the network?

SKILL.md names 1 domain. In commands or code: raw.githubusercontent.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Writing Guidelines safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Guidelines use?

No licence was found for Writing Guidelines or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Writing Guidelines use?

About 309 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Guidelines?

Skills that share tags, products or a category with Writing Guidelines: Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), Brand (Ohh-889/skyroc, 795 stars), Khazix WeChat Article Writer (KKKKhazix/khazix-skills, 21k stars) and Unslop AI Writing Cleanup (theclaymethod/unslop, 516 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Guidelines?

vercel-labs (a GitHub organization, an official publisher) maintains it in vercel-labs/agent-skills, which has 32,103 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 28, 2026.

Source: vercel-labs/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.