Name: vale-linter
Rating: 91 (1 reviews)
Author: circleci

vale-linter

Run the Vale prose linter on CircleCI documentation files to identify and fix style errors, then create pull requests for review. Use this skill when the user explicitly asks to "run vale", "fix vale errors", "lint docs with vale", or mentions vale linting. This skill processes documentation files, fixes error-level Vale issues, and creates individual PRs per file for easier review.

1.33x

Quality

—

Does it follow best practices?

Impact

91%

1.33x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

82%

17%

Documentation Lint Cleanup

Error-only filtering and one PR per file

Criteria

Without context

With context

JSON output flag

Errors only — no warnings fixed

100%

One branch per file

100%

Branch naming convention

25%

100%

Heading punctuation fix

100%

Contraction fix

Gender bias fix

100%

Oxford comma fix

100%

Hedging fix

100%

AsciiDoc structure preserved

100%

One PR per file

100%

96%

34%

Prose Linting for Documentation Contribution

Commit and PR format with re-verification

Criteria

Without context

With context

Commit message title format

62%

100%

Commit lists errors fixed

100%

Co-authored-by line

100%

PR title format

62%

100%

PR Summary section

100%

PR Errors Fixed section

100%

PR Verification section

37%

100%

PR Notes section

100%

Re-verification documented

90%

100%

Errors only fixed

80%

100%

Contraction and hedging fixes

50%

Gender bias fix

100%

95%

17%

Multi-File Documentation Lint Sprint

Summary report and same-filename branch naming

Criteria

Without context

With context

Summary report file

100%

Summary: files processed count

100%

Summary: PRs created count

100%

Summary: PR detail per file

100%

Partial path in branch names

100%

One branch per file

100%

Errors only — no unrelated changes

60%

100%

Heading punctuation fix

100%

Contraction fixes

100%

Gender bias fix

100%

Oxford comma fix

100%

Hedging fix

Repository: circleci/circleci-docs
Commit: 65ff472

Evaluated: 30 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Documentation Lint Cleanup Prose Linting for Documentation Contribution Multi-File Documentation Lint Sprint

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.