Vale's text.frontmatter.description scope silently stops matching once the description is a YAML block scalar spanning 2+ physical lines — the style used by most skills/agents in this repo. scripts/vale-wrap.sh flattens the description to one line in a scratch copy (preserving the repo-relative path and total line count) before invoking real vale, and both audit skills plus the pre-commit hook now call it instead of vale directly. Also tightens the pre-commit hook's file glob to single path segments so it can't cross into docs/research examples or asset templates the way the audit skills' scoped invocations already avoid. Addresses PR #85 review feedback. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01FxG5T8EJDgkABXxuneuFfn
vale-config
Install and configure Vale, the prose/style linter — .vale.ini, StylesPath, built-in/third-party/custom styles, and activation via BasedOnStyles.
What it does
Covers the setup side of Vale: getting a project from no config to a working .vale.ini where vale sync runs clean and every declared style is actually activated for the right files. Does not run Vale or interpret its output — see vale-run for that.
Usage
/vale-config
Describe what you want configured: initial setup, adding a third-party style package, or a custom rule. The skill covers install, StylesPath layout, .vale.ini structure, and BasedOnStyles activation.
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
references/configuration-reference.md |
Full .vale.ini field and rule-header reference |
references/sources.md |
Research sources backing the Vale configuration guidance |