skill-vale

Diagnose Vale configuration, StylesPath, and lint rule loading issues.

19|29|Updated May 6, 2013
One-click install
npx skills add https://github.com/qt/qtqa --skill skill-vale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-vale
Source: https://github.com/qt/qtqa/tree/main/documentation_review/skills/skill-vale
Command: npx skills add https://github.com/qt/qtqa --skill skill-vale

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vale configuration and lint issues can be confusing or difficult to diagnose; this guide provides a concise reference for config file resolution, StylesPath loading, package synchronization, format detection, and common error messages to speed debugging.

Core Features & Use Cases

  • Clarifies how Vale discovers and resolves configuration files (.vale.ini) across the directory tree from the file being linted
  • Explains StylesPath setup, vale sync behavior, and how rules are loaded
  • Provides troubleshooting steps for common misconfigurations in CI or local development
  • Offers guidance for interpreting common error messages and ensuring consistent behavior

Quick Start

Run ls-config to inspect the resolved Vale configuration and adjust your .vale.ini and StylesPath accordingly.

Frequently Asked Questions about skill-vale

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does Vale discover .vale.ini configuration files across nested directories?

Vale resolves .vale.ini configuration by searching the directory tree upwards from the linted file. This guide clarifies config file resolution behavior to help you verify which settings apply to specific project paths.

Why is my Vale StylesPath not loading rules correctly?

Your Vale StylesPath may be misconfigured or packages out of sync. This guide troubleshoots StylesPath setup, vale sync status, and rule loading to ensure your custom styles load properly across the project.

How do I debug Vale lint issues in CI or local development?

Debug Vale lint issues by running the ls-config command to inspect the resolved configuration. This guide provides troubleshooting steps for common misconfigurations encountered in CI or local development environments.

What do common Vale error messages about format detection mean?

Common Vale error messages about format detection indicate issues with format mappings in your .vale.ini. This guide helps interpret these errors and verify format mappings to ensure consistent linting behavior.

Can I use Vale with multiple configuration files in a monorepo?

Yes, Vale supports multiple .vale.ini files across nested directories. This guide explains how configuration file resolution works across the directory tree to help you manage styles and rules for different project sections.