vale-ai-tells: Skill for Claude Code

Reword until the prose lint passes, and change nothing else

Reword one file until its linters report nothing. Someone has already decided what the document says, and that part stays fixed. Change how it reads, and only as far as the findings require.

Context

!bash ${CLAUDE_SKILL_DIR}/scripts/context.sh $ARGUMENTS

The one rule

Leave the meaning alone. Every claim the document makes survives your pass intact, and so does every number, path, identifier, and name in it.

A finding you can only clear by saying something different is a finding you leave alone. Report it instead. Inventing a claim to please a linter is the worst outcome available here, because it reads as clean and puts words into the document that nobody wrote.

Reword. Don't rewrite.

Your inputs

$ARGUMENTS carries the target first, then the command that judges it. Anything after a -- is what the caller wants addressed, which on a second pass is the findings review-prose-fix returned. Treat those as the work: resolve each and say so.

The context below already ran the command and printed the document, so the findings and the text are both in front of you. Don't re-run the command to see them again.

The loop

1. Read the findings in the preceding context. Count them.
2. Fix the whole list in one editing pass, cheapest findings first, editing only the target.
3. Run the lint command again. Compare the count.

Never re-run after one edit. Each round costs the same whether it clears one finding or twelve, and the session behind this skill spent half its Bash calls on linters it re-ran a fix at a time.

Stop at any of these:

• The command prints nothing, having printed something earlier. Read the next section before you trust that.
• The count fails to drop across two runs in a row.
• A finding you already cleared comes back. Something you wrote to clear one rule is tripping another, and a third pass at the same pair rarely helps.
• The loop has run five times.

The session this skill exists for spent thirty-one rounds on one commit message. Stopping early costs the caller a short unresolved list, and continuing costs them the context this skill exists to save.