stylint

name	stylint
description	Run and fix stylint checks for prose, Markdown, lessons, workshops, docs, and agent-written text. Use when editing written content or when the user asks for style, polish, or lint cleanup.
allowed-tools	Bash(stylint *), Bash(uv run stylint *), Bash(~/git/stylint/install.sh), Bash(cd ~/git/stylint && ./install.sh)

Stylint

Use stylint when editing prose, Markdown, workshop lessons, docs, or agent-written explanations.

Before Editing

Read the agent guide first:

stylint --agents

If the task needs a specific guide, print it directly:

stylint --style-guide voice
stylint --style-guide formatting
stylint --style-guide code-style
stylint --style-guide polish

Run Checks

Check the current project:

stylint

Check a specific folder or repo:

stylint path/to/content

Exclude folders or files that are outside the requested scope:

stylint path/to/content --exclude _docs --exclude AGENTS.md --exclude README.md

Use --ignore only for investigation. Do not use it as the final verification pass, because one edit can introduce a different kind of issue.

Fix Findings

• Fix high-confidence mechanical findings first.
• Use judgment for long sentences, comma warnings, and list suggestions.
• Preserve meaning and intensity; do not make the text more excited than the source.
• Do not blindly turn every comma sentence into bullets. Use bullets only for real lists or steps.
• Prefer rewriting scaffold like The result is..., Rule of thumb:, or The only question is: into the direct sentence.

After editing, always run the full check again without --ignore:

stylint path/to/content

If Stylint Is Missing

If the checkout exists, install it into the shell path:

cd ~/git/stylint && ./install.sh
source ~/.bashrc

Inside the stylint checkout, this also works:

uv run stylint