Skip to content
cccskills
FreePublished on GitHubEnglish overview

writing-guidelines

Review documentation and prose against the Vercel Writing Guidelines, checking voice, tone, formatting, and structure. Findings identify files and line numbers, using a bundled guideline snapshot as the default reference for repeatable reviews.

OriginalShow the original description

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

nexu-io/open-design
Works withVercel
AI rating100/ 100See how to install

Good for

  • Reviewing documentation before publication
  • Checking voice and tone across several files
  • Finding formatting and structural issues
  • Comparing updated guidelines with the bundled snapshot

Overview

What it does

This skill checks documentation and prose against the Vercel Writing Guidelines. It reviews specified files or filename patterns for voice, tone, formatting, and structure, then returns concise findings in file:line format. Each finding points to a file and line number, making it easier to compare the review with the original text and locate passages that need attention.

When it helps

Use it to review documentation before publication or check multiple pieces of writing against the same standard. It also supports ongoing reviews where you want a shared reference that stays consistent from one review to the next.

Example requests

  • “Check this document’s voice, tone, formatting, and structure against the guidelines.”
  • “Review the specified files and return findings with filenames and line numbers.”
  • “Compare the latest guidelines with the bundled version.”

Notes

The default reference is the pinned version in references/guidelines.md. Fetching the latest version and checking differences are optional and require access to an external URL. If the review target has not been specified, provide the files or filename pattern to check.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt clearly states that it checks writing-guideline compliance by reading the specified documentation or prose files.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt sequences loading the pinned guidelines, reading target files, applying rules, and reporting findings in file:line format.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodThe default uses bundled files, and fetching the latest guidelines from an external URL is explicitly optional.
Easy setupDoes it need few tools or API keys, and are they documented?
AGoodThe default reference is bundled, and no mandatory additional tools or API keys are specified.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 20, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (3)

  • SKILL.md2.3 KB
  • LICENSE1.0 KB
  • references/guidelines.md13.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Writing Guidelines

Review files for compliance with Writing Guidelines.

How It Works

  1. Load the pinned guidelines from references/guidelines.md — this is the default, reproducible execution path
  2. Optionally, fetch the latest guidelines from the upstream URL below and diff against the pinned snapshot to see if anything has changed
  3. Read the specified files (or prompt user for files/pattern)
  4. Check against all rules in the guidelines
  5. Output findings in the terse file:line format

Guidelines Source

Default (pinned): The vendored copy at references/guidelines.md is the default execution path. It is a pinned snapshot of the upstream guidelines and guarantees the skill produces reproducible results in any runtime environment.

Upstream (live): For users who want the very latest rules, the live source is available at:

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

Fetching the live version is optional — the pinned snapshot is always the baseline.

Usage

When a user provides a file or pattern argument:

  1. Load references/guidelines.md as the default source
  2. Optionally fetch the upstream URL to check for updates
  3. Read the specified files
  4. Apply all rules from the guidelines
  5. Output findings using the format specified in the guidelines

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

8-bit-orbit-video-template

FreeSummaryAI rating 90

Create a three-scene video composition in a retro pixel style using a Hyperframes HTML template. Customize titles, labels, and colors while preserving scene transitions, short scene durations, and repeatable animation timing.

  • Create a retro pixel presentation video
  • Customize a three-scene video template
  • Preview scene transitions and motion in HTML
nexu-io/open-design102.7KUpdated Oct 20, 2026

ad-creative

FreeSummaryAI rating 80

Create and revise headlines, descriptions, and main text for paid social and search ads. Use it to develop ad copy options and refine wording through repeated rounds of revision.

  • Drafting headlines for paid social ads
  • Creating descriptions for search ads
  • Revising the main text of an ad
nexu-io/open-design102.7KUpdated Oct 20, 2026

after-hours-editorial-template

FreeSummaryAI rating 80

Create a three-page editorial motion sequence with dark backgrounds, serif typography, staged text reveals, and chapter transitions. The result is a single HTML file suited to fashion-inspired storytelling and short visual presentations.

  • Creating a fashion-inspired motion presentation
  • Presenting a short story across three pages
  • Applying existing brand rules to a dark editorial sequence
nexu-io/open-design102.7KUpdated Oct 20, 2026

agent-browser

FreeSummaryAI rating 100

Inspect and test web pages through a browser automation command-line tool. Navigate, click, enter text, capture screenshots, and extract page details, with a focus on checking local OpenDesign previews and reviewing web app quality.

  • Checking local OpenDesign previews
  • Testing clicks and text entry in web apps
  • Capturing page or element screenshots
nexu-io/open-design102.7KUpdated Oct 20, 2026

ai-music-album

FreeSummaryAI rating 80

Plan an AI music album from its concept through lyric drafts, track order, and export. Intended for independent album experiments and brand soundtracks, with the full production workflow provided through a separately installed upstream bundle.

  • Planning an experimental independent album
  • Drafting lyrics around an album concept
  • Deciding the running order of tracks
nexu-io/open-design102.7KUpdated Oct 20, 2026

algorithmic-art

FreeSummaryAI rating 80

Create generative art, or images made with programmed rules, using p5.js. Fixed random seeds make each rendering reproducible, supporting procedural posters, still images that suggest motion, and studies of artistic frame composition.

  • Posters generated with programmed rules
  • Still images that suggest motion
  • Studies of artistic frame composition
nexu-io/open-design102.7KUpdated Oct 20, 2026

See all skills by nexu-io

Report a problem with this skill