Creative
Vale for creative writing
Fiction, essays, and the rules writers have argued over for a century.
The craft advice in a writing book is a list of things to watch for, which is what a linter does. The Fiction package flags filter words, told emotions, stock phrases, and dialogue punctuation, with Elmore Leonard’s rules, Chuck Palahniuk’s, and Strunk’s 1918 Elements of Style beside them. Most rules are suggestions: a second reader pointing, not a gate.
Start with this config
The Fiction package with Leonard’s rules on the manuscript. Readability scores stay suggestions, so they inform a revision rather than block one.
.vale.ini
StylesPath = styles
MinAlertLevel = suggestion
Packages = Fiction, Readability
[manuscript/*.md]
BasedOnStyles = Vale, Fiction, Leonard, Readability Then download the packages it names and run Vale over the project:
$ vale sync
$ vale . Packages
Published styles to start from. A package in the Explorer installs by name with Packages and vale sync, one published elsewhere by its release URL, and every rule in either can be turned off or changed in your own config.
Fiction
Fiction: filter words, told emotions, stock phrases, and dialogue punctuation, with the rules of Elmore Leonard, Chuck Palahniuk, and Strunk's 1918 Elements of Style.
24 rules 866 downloads
Voices
Writing voices as Vale rules: a shared core against hedging, puffery, weasel words, and throat clearing, and voices such as Direct, Simple, and Human that set how the prose should sound.
34 rules 14.4K downloads
Readability
Readability scores: Automated Readability Index, Coleman-Liau, Flesch-Kincaid, Flesch reading ease, Gunning fog, LIX, and SMOG, with a rule that names the polysyllables behind them.
8 rules 288K downloads
proselint
proselint places the world’s greatest writers and editors by your side.
120 rules 890.8K downloads
write-good
Naive linter for English prose for developers who can't write good.
9 rules 1.5M downloads
Where it runs
Writers draft in notes apps and plain editors more than in IDEs. Each of these shows alerts as you type, from the same config the manuscript uses.
- Obsidian obsidian-vale
- Browser Chrome, Edge, Firefox
- VS Code VS Code, Cursor, Windsurf
- Emacs flymake-vale
- Zed zed-vale
- Sublime Text LSP-vale-ls
With an agent
All agent toolsThe agent tools install as a Claude Code plugin: skills for setting up and tuning Vale, and hooks that lint each file the assistant writes. Type both lines in Claude Code, then ask for what you need.
/plugin marketplace add vale-cli/agent-tools
/plugin install vale@agent-tools - “add prose linting” /vale:setup Install Vale, write a .vale.ini that matches the formats actually present, sync the styles, and get a first run. Covers translated docs and the comments in source code.
- “use title case headings” /vale:tune Change one style choice in plain words: headings, contractions, “we”, passive voice, preferred terms. Ships tested templates for the choices no package covers.
- “flag this phrase” /vale:rule Write one rule for a house convention, with test cases beside it, and prove it with vale test and a run on the real corpus.
- “stop flagging our product name” /vale:vocab Add project terms to a vocabulary, import a word list kept for another spell checker, and set up a regional or other-language dictionary.
Who runs it
Teams who lint long-form writing: the manuscript of a book, a blog, an open handbook. None in the directory lint fiction yet; the Fiction package is new.
- Thinking in Python Bruce Eckel lints the manuscript of his book for house style, with spelling left to codespell.
- LinuxBoot Lints the LinuxBoot book with Red Hat's style, proselint, alex, Joblint, and write-good.
- Open Liberty Checks its AsciiDoc blog posts with Google's style and four house styles.
- Rackspace Custom style for the Rackspace Expert Insights technical blog.
- InnerSource Commons Publishes an ISC style package and runs it on its patterns, learning path, and handbook.
- PostHog Documents Vale and prose linting in the public company handbook.
- TrussWorks TrussWorks' public software engineering playbook.
- Matter Lints the Matter Handbook with its own Matter style.
- Stakater Publishes a Stakater style package and runs it across 27 repos, from Reloader to its handbooks.
- Engineering Handbook Lints an open system-design and AI engineering handbook with proselint, write-good, alex, and Readability.
Formats
Where this kind of writing lives. Vale parses each one, so rules see the prose and skip the markup, the code, and the URLs.
Read more
On the blog
- Introducing Voices: AI writing skills as Vale rules The writing skill you would reach for, rewritten as Vale rules. Checked on every draft rather than remembered, and free until something breaks one.
- Introducing Std: The standard library for Vale General-purpose rules you extend to build your own style, extracted from the styles teams already run.
In the docs
- Styles
Turning your own rules into checks
- Vocabularies
Names and invented words
- Spelling
Other kinds of writing
Technical
Docs, references, and the style guide your team already follows.
Read the guidePublic sector
Plain English for the public, held to a government style guide.
Read the guideResearch
Papers, notebooks, and the docs for the software research runs on.
Read the guideCode & data
The prose inside files that aren’t prose: comments, API descriptions, and the log.
Read the guideAI & agents
Hold what a model writes, and what you write for one, to a standard.
Read the guide