// 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.
| 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) |
Use stylint when editing prose, Markdown, workshop lessons, docs, or agent-written explanations.
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
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.
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 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
Fetch and transcribe Google Recorder voice notes. Use when the user shares a recorder.google.com link and wants the original audio file, a transcript, or wants to act on a voice note.
Initialize a new Python library with modern tooling, packaging, tests, and optional CLI support. Use when the user wants to scaffold a new Python package.
Add the standardized CI publish workflow (`.github/workflows/publish.yml` + `make release`) to an existing Python project so PyPI releases happen on tag push. Use when a project still publishes via a local script (`publish.py`, `hatch publish`, `twine upload`) or has no automated publish at all.
Release the current project to its package registry and GitHub by bumping the version, pushing a tag, and letting CI publish. Works for any project (Python/PyPI, Rust/crates.io, Node/npm, etc.) that has a CI publish workflow keyed off `v*` tags.
Transcribe local audio files with the OpenAI Audio Transcriptions API without adding OpenAI dependencies to the target project.
Fetch YouTube video transcripts. Use when the user asks to get a YouTube video transcript, subtitles, or captions, or wants to analyze/summarize a YouTube video.