writing-guidelines SKILL.md skillA

writing-guidelines from vercel-labs/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vercel-labs/agent-skills/writing-guidelines@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
vercel-labs/agent-skills
Path
skills/writing-guidelines/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed May 26, 2026
Size
1,233 bytes
Repository stars
33,725
License
none declared

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".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Writing Guidelines

Review files for compliance with Writing Guidelines.

## How It Works

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

## Guidelines Source

Fetch fresh guidelines before each review:

```
https://raw.githubusercontent.com/vercel-labs/writing-guidelines/main/command.md
```

Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.

## Usage

When a user provides a file or pattern argument:
1. Fetch guidelines from the source URL above
2. Read the specified files
3. Apply all rules from the fetched guidelines
4. Output findings using the format specified in the guidelines

If no files specified, ask the user which files to review.

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vercel-labs/agent-skills/writing-guidelines@sha256:89a5f581193289b8

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_dluqaqj2tnmquvda.svg)](https://markdownregistry.com/a/art_dluqaqj2tnmquvda)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 26, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-26 2f423a2 1,233 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1233 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vercel-labs/agent-skills · 33,725 stars · license none declared · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dluqaqj2tnmquvda
GET https://markdownregistry.com/api/v1/resolve?ref=vercel-labs/agent-skills/writing-guidelines
GET https://markdownregistry.com/api/v1/blob/89a5f581193289b80af58b980090aeed535047c8df2b55ccbaae0de40283a99d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from vercel-labs/agent-skills

AGENTS.md AGENTS.md file
vercel-labs/agent-skills · AGENTS.md
git:20260515.39c80b2 · audit A · 33,725 stars
CLAUDE.md CLAUDE.md file
vercel-labs/agent-skills · CLAUDE.md
git:20260105.20f4a04 · audit B · 33,725 stars
AGENTS.md@skills/composition-patterns AGENTS.md file
vercel-labs/agent-skills · skills/composition-patterns/AGENTS.md
git:20260128.a5343bd · audit A · 33,725 stars
vercel-composition-patterns SKILL.md skill
vercel-labs/agent-skills · skills/composition-patterns/SKILL.md
v1.0.0 · audit B · 33,725 stars
deploy-to-vercel SKILL.md skill
vercel-labs/agent-skills · skills/deploy-to-vercel/SKILL.md · Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy…
v4.0.0 · audit A · 33,725 stars
AGENTS.md@skills/react-best-practices AGENTS.md file
vercel-labs/agent-skills · skills/react-best-practices/AGENTS.md
git:20260414.dc8367e · audit B · 33,725 stars
vercel-react-best-practices SKILL.md skill
vercel-labs/agent-skills · skills/react-best-practices/SKILL.md · React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing…
v1.0.0 · audit A · 33,725 stars
AGENTS.md@skills/react-native-skills AGENTS.md file
vercel-labs/agent-skills · skills/react-native-skills/AGENTS.md
git:20260127.485beb8 · audit A · 33,725 stars
vercel-react-native-skills SKILL.md skill
vercel-labs/agent-skills · skills/react-native-skills/SKILL.md
v1.0.0 · audit B · 33,725 stars
AGENTS.md@skills/react-view-transitions AGENTS.md file
vercel-labs/agent-skills · skills/react-view-transitions/AGENTS.md
git:20261027.6ec2693 · audit A · 33,725 stars
vercel-react-view-transitions SKILL.md skill
vercel-labs/agent-skills · skills/react-view-transitions/SKILL.md · Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>`…
v1.0.0 · audit A · 33,725 stars
vercel-cli-with-tokens SKILL.md skill
vercel-labs/agent-skills · skills/vercel-cli-with-tokens/SKILL.md · Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access…
v1.0.0 · audit A · 33,725 stars

Every file in vercel-labs/agent-skills

Other files named writing-guidelines

writing-guidelines SKILL.md skill
rohitg00/pro-workflow · skills/writing-guidelines/SKILL.md · Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR…
git:20260718.7f7209d · audit A · 2,944 stars
writing-guidelines SKILL.md skill
fcakyon/claude-codex-settings · plugins/frontend-design-skills/skills/writing-guidelines/SKILL.md · This skill should be used when the user asks to "review writing", "check documentation style", "audit interface copy"…
git:20260827.42d53f9 · audit A · 1,200 stars

Browse by kind, by grade A, or by owner.