diff --git a/plugins/lint/skills/vale-config/SKILL.md b/plugins/lint/skills/vale-config/SKILL.md index 2d52429..43591c4 100644 --- a/plugins/lint/skills/vale-config/SKILL.md +++ b/plugins/lint/skills/vale-config/SKILL.md @@ -21,8 +21,7 @@ metadata: - Installing the `vale` binary installs no styles. A fresh `.vale.ini` with `BasedOnStyles` set will fail or find nothing until `vale sync` runs and downloads the `Packages` it declares. - `.vale.ini` is order-sensitive: global (core) settings first, then the optional `[formats]` section, then glob sections (`[*]`, `[*.md]`, …). Settings in a glob section only apply to files matching that glob. -- Declaring `StylesPath` and `Packages` alone activates nothing. A style only lints files once it's listed in `BasedOnStyles` under a glob section that matches those files — this is the step people forget. -- `Packages` (top-level, for `vale sync` to fetch) and `BasedOnStyles` (per-glob, to activate) are two different keys serving two different purposes. Both are required for a third-party style to actually run. +- `Packages` (top-level, fetched by `vale sync`) and `BasedOnStyles` (per-glob, activates) are separate keys — a style only lints files once it's in both. This is the step people forget. ## Setup workflow diff --git a/plugins/lint/skills/vale-run/SKILL.md b/plugins/lint/skills/vale-run/SKILL.md index cff78af..8b0d78c 100644 --- a/plugins/lint/skills/vale-run/SKILL.md +++ b/plugins/lint/skills/vale-run/SKILL.md @@ -12,7 +12,7 @@ description: > vale-config skill. metadata: version: "0.1.0" - category: linting + category: lint source_keys: - context7-websites-vale-sh ---