vale-tools

v0.0.1

Vale linting tools for validating documentation using Vale CLI.

Important: Always run Claude Code from a terminal in the root of the documentation repository you are working on.

Prerequisites

Install the GitHub CLI (gh) and authenticate:

gh auth login

# Fedora/RHEL
sudo dnf copr enable mczernek/vale && sudo dnf install vale

# macOS
brew install vale

A .vale.ini file should exist in the project root. Minimal example:

StylesPath = .vale/styles

MinAlertLevel = suggestion

Packages = RedHat

[*.adoc]

BasedOnStyles = RedHat

[*.md]

BasedOnStyles = RedHat

Run vale sync to download the style packages after creating the config.

/plugin install vale-tools@redhat-docs-agent-tools

/plugin marketplace update redhat-docs-agent-tools

Skill	Description
`lint-with-vale`	Run Vale linting to check for style guide violations. Supports Markdown, AsciiDoc, reStructuredText, HTML, XML, and source code comments. Use this skill when asked to lint, check style, or validate documentation.
`update-vale-rules`	Run Vale RedHat rules against PR/MR changed files only, analyze output for false positives with 90%+ certainty, and create a PR to update vale-at-red-hat rules. Use this skill when asked to improve Vale rules, find false positives in a PR, or update the Vale at Red Hat style guide.