
Writing Guidelines
FreeEnsure your documents meet writing style standards.
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 source1. Install with the skills CLI
npx skills add nexu-io/open-design/writing-guidelines --agent claude-code2. 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-ioWriting Guidelines
Review files for compliance with Writing Guidelines.
How It Works
- Load the pinned guidelines from
references/guidelines.md— this is the default, reproducible execution path - Optionally, fetch the latest guidelines from the upstream URL below and diff against the pinned snapshot to see if anything has changed
- Read the specified files (or prompt user for files/pattern)
- Check against all rules in the guidelines
- Output findings in the terse
file:lineformat
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:
- Load
references/guidelines.mdas the default source - Optionally fetch the upstream URL to check for updates
- Read the specified files
- Apply all rules from the guidelines
- 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
String Reviewer
Improve clarity and consistency of user-facing strings.
Finnish Humanizer
Transform AI-generated Finnish text into natural language.
Copy Editing
Enhance your marketing copy systematically and effectively.
Content Humanizer
Transform AI text into authentic human writing.
Write Prose Polisher
Enhance your writing by removing AI-like patterns.
DetectAI
Determine if text is AI-generated with dual methods.
