Vale CMS Need more than a rule playground? Explore
Package Explorer

Prompts

Lints instruction files such as AGENTS.md, CLAUDE.md, and SKILL.md: advice in place of commands, vague verbs, contradictions, too much emphasis, and files too long to read on every turn.

jdkato/prompts 2 stars 24 downloads v0.1.1 · Nov 21, 2026 latest release style Vale ≥ 3.21.0

Getting started

Add it to your .vale.ini, then run vale sync.

Packages = Prompts

[*.md]
BasedOnStyles = Vale, Prompts

The name installs the latest release each time vale sync runs. To stay on v0.1.1, the release this page describes, give its URL instead:

Packages = https://github.com/jdkato/prompts/releases/download/v0.1.1/Prompts.zip

Rules 13

4 error8 warning1 suggestion
  • Prompts.Absolutes warning occurrence scope: summary Style guide

    %d absolutes in one file. Past ten, none of them lands.

  • Prompts.Contradiction warning consistency Style guide

    '%s' pulls against an earlier instruction. Say when each applies.

  • Prompts.Emphasis warning occurrence scope: summary Style guide

    %d lines shouting. Emphasize one, and the rest stand out less, not more.

  • Prompts.Frontmatter error existence scope: raw Style guide

    '%s' runs past what a skill loader accepts: 64 characters for a name, 1,024 for a description.

  • Prompts.Imperative warning existence scope: sentence Style guide

    Give the instruction, not the advice: '%s'.

  • Prompts.Length warning metric Style guide

    A file of %s words, read on every turn. Move what is only sometimes needed into a skill or a linked file.

  • Prompts.Paths error existence Style guide

    A path with backslashes: '%s'. Use forward slashes, even on Windows.

  • Prompts.SectionLength suggestion metric scope: doc(section:has(> h2)) Style guide

    A section of %s words. Give the second half its own heading.

  • Prompts.SkillName error existence scope: raw Style guide

    '%s' is not a valid skill name: use lowercase letters, numbers, and hyphens, without 'anthropic' or 'claude'.

  • Prompts.ThirdPerson error existence scope: raw Style guide

    A description reads in the third person: not '%s'.

  • Prompts.TimeSensitive warning existence Style guide

    '%s' will be wrong soon. State the current method, and put the old one under its own heading.

  • Prompts.Trigger warning existence scope: raw Style guide

    The description says what the skill does but not when to use it. Add 'Use when ...'.

  • Prompts.Vague warning existence Style guide

    '%s' says nothing about what to do. Say what.