Files
holocron/plugins/lint/skills/vale-config
Defame1297 0bbb965cd4 fix(lint): flatten multi-line frontmatter descriptions before Vale runs
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
2026-07-24 10:16:35 +00:00
..
2026-07-23 19:11:38 +00:00

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