Files

Defame1297 4d6f313b1e fix(lint): resolve audit findings on vale skills

Merge duplicate gotcha in vale-config (Packages vs BasedOnStyles was
stated twice) and align vale-run's category field with vale-config's
(lint, not linting) so sibling skills in the plugin agree.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FxG5T8EJDgkABXxuneuFfn

2026-07-23 19:24:59 +00:00

references

feat(lint): add vale-run skill

2026-07-23 19:12:25 +00:00

README.md

feat(lint): add vale-run skill

2026-07-23 19:12:25 +00:00

SKILL.md

fix(lint): resolve audit findings on vale skills

2026-07-23 19:24:59 +00:00

README.md

vale-run

Run Vale (a prose/style linter) against an already-configured project and interpret its results.

What it does

This skill covers invoking the vale CLI against files or directories, choosing an output format (human-readable CLI, line, or machine-parseable JSON), filtering by severity via --minAlertLevel, and handling exit codes in scripts and CI. It also covers resolving common runtime issues: false positives, format-specific inline suppression, and CI failures caused solely by Vale's non-zero exit code. It assumes the project already has a working .vale.ini and installed styles — setting those up is the sibling vale-config skill's job.

Usage

/vale-run

Describe what you want to lint and how (human-readable output, CI/JSON output, filtered by severity). The skill will pick the right flags and, if results include false positives, walk through the narrowest applicable fix.

Files

File	Purpose
`SKILL.md`	Core invocation, key flags, output format guidance, false-positive triage order
`references/troubleshooting.md`	Inline suppression syntax, rule-specific disabling, spelling ignore lists, pre-commit integration, CI edge cases
`references/sources.md`	Research provenance