.agents/skills/review-verbosity/SKILL.md
New comments and docstrings are usually too verbose. Rewrite them concisely. This skill edits — it doesn't just report.
git diff --stat origin/main...HEAD # which crates changed
git diff origin/main...HEAD
Dispatch one sub-agent per changed area — a crate, or any other group of changed files,
so nothing outside crates/ is missed — then review their edits yourself. A single pass
over a large diff won't be exhaustive. In every comment the branch touched:
ignore.Python docstrings are markdown: single backticks, never RST double-backticks.
Only touch what this branch added or changed, unless asked for a wider sweep. Don't change behaviour — if a comment is wrong because the code is wrong, say so rather than rewording it to match. Concision, not terseness: an unfollowable comment is worse than a long one.
make format-rs && make lint-rs
git diff --stat # format-rs is `cargo +nightly fmt --all` — check it touched only your files
Then report what you cut, by file, in a couple of lines — not a full inventory.