New to Claude Skills? Learn how to install them →

nexu-io on GitHub

Writing Guidelines

Free

Ensure your documents meet writing style standards.

by nexu-io84.9k stars on nexu-io/open-design
2 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Writing Guidelines does

The Writing Guidelines skill is designed to help users review their documents and prose for compliance with established writing standards. By utilizing a pinned set of guidelines found in references/guidelines.md, this skill provides a reliable way to audit writing style, voice, and tone. Users can invoke the skill by requesting a review of their documents, ensuring that their writing adheres to the specified guidelines.

The skill operates by loading the pinned guidelines as a default execution path, which guarantees reproducibility across different runtime environments. Users have the option to fetch the latest guidelines from an upstream URL, allowing them to stay updated with any changes in writing standards. This feature is particularly useful for teams that need to maintain consistency in their documentation while also adapting to evolving guidelines.

When a user specifies files for review, the skill reads those files and checks them against all rules outlined in the guidelines. The findings are presented in a concise file:line format, making it easy for users to identify areas that require attention. If no files are provided, the skill prompts the user to specify which documents to review, ensuring a user-friendly experience.

This skill is ideal for writers, editors, and teams focused on maintaining high-quality documentation. It streamlines the review process, saving time and enhancing the overall quality of written materials by ensuring compliance with established writing standards.

When to use it

Use this skill when you need to ensure your documents align with specific writing guidelines or standards.

When not to use it

This skill may not be suitable for creative writing or scenarios where strict adherence to guidelines is not required.

What you can build with it

Team Documentation Review

Use this skill to audit team documentation for compliance with writing standards, ensuring consistency across all materials.

Content Quality Assurance

Integrate this skill into your content creation workflow to maintain high-quality writing by regularly checking documents against guidelines.

Onboarding New Writers

Help new writers understand and adhere to your organization's writing standards by using this skill to review their initial drafts.

How to install Writing Guidelines

View source

1. Install with the skills CLI

npx skills add nexu-io/open-design/writing-guidelines --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by nexu-io

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.

Frequently asked questions about Writing Guidelines

Similar skills