All products

Teach Vale project spellings with AI

Teach Vale which project spellings to accept and which retired names to flag, keeping normal spelling checks active for the rest of the document.

Teach Vale project spellings with AI when spellcheck repeatedly flags the correct name of a product or an API. The vocab skill starts from genuine matches found in your documents. It helps the agent separate the terms your team has approved from ordinary misspellings that should still be corrected.

A rebrand is a good test. You may want the new name recognised with its exact capitalisation while the old spelling is actively flagged. One list accepts approved terms and the other rejects retired ones. Run the same document again to check both behaviours before committing the files.

What it does

  • Extract genuine spelling matches and count how often each term appears.
  • Confirm spelling against the product or the project’s own approved documentation.
  • Add the chosen term to the accept list with its intended case.
  • Put an old product name or a specifically banned spelling on the reject list.
  • Run another check and commit the vocabulary so colleagues can use it.

Install and use

  1. Install the skill with Vale, jq and Git. Start from a working project configuration and a document containing the names to test.
  2. Ask “Accept the official spelling of this feature and flag its old name. Show me the result on this guide.”
  3. Review the selected entries, run the check again and commit the project vocabulary.

FAQ

Source

Made by Joseph Kato (Vale). Original skill: vocab, published on GitHub under the MIT licence.

View on GitHub