Add the proofread skill and sweep repository prose - #143
Merged
Conversation
Introduce a skill that fixes English grammar, punctuation, and spelling in project-owned comments and documentation, in branch-diff, full-sweep, or path-scoped mode. Add the two guidelines it applies: `english-style.md`, the catalog defining what counts as an error and when to leave an occurrence alone, and `project-owned-files.md`, the boundary that keeps a sweep out of the `config` submodule and the files it distributes. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Apply the `proofread` skill in full-sweep mode. Correct restrictive `which` to `that`, the gerund form required after `allow` without an object, subject-verb agreement, missing articles, one hyphenation, one dialect outlier, and several double spaces. Repair three editing artifacts: a duplicated word, a run-together token, and a fused clause. Only comment and Markdown prose changed. Refresh the copyright year on every file touched. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
proofread skill and sweep repository prose.proofread skill and sweep repository prose
Oleg-Melnik
marked this pull request as ready for review
July 28, 2026 11:54
armiol
approved these changes
Jul 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a
proofreadskill that corrects English grammar, punctuation, andspelling in project-owned comments and documentation, together with the style
catalog and file-ownership boundary it applies. Also lands the skill's first
repository-wide sweep and updates the agent policy for pull request titles.
The repository-wide sweep touches comment and Markdown prose only. Within that
sweep, no code, identifier, string literal, link target, or generated file
changed, and every affected source file stays balanced at equal insertions and
deletions.
Changes
Skill, command, and guidelines
.agents/skills/proofread/(SKILL.md,agents/openai.yaml) and the.claude/commands/proofread.mdentry point. The skill runs in three modes:branch diff (default),
allfor a full sweep, or a path for a scoped sweep..agents/guidelines/english-style.md, the catalog that defines whatcounts as an error and, for each topic, when to leave an occurrence alone.
.agents/guidelines/project-owned-files.md, the boundary that keeps anysweep out of the
configsubmodule and the files it distributes..agents/skills/README.md.AGENTS.mdto require pull request titles without a trailing period.Prose sweep — 47 files
whichtothatwhere the clause identifies its antecedent,leaving non-restrictive and preposition-governed uses alone (~45 places).
allows to <verb>to the gerund form required afterallowwithout anobject, for example
allows to amendtoallows amending(~20 places).spaces, and one dialect outlier (
behaviourtobehaviorin a file that isotherwise American).
a clause left fused to its replacement.
AGENTS.md.Version
chordsVersionto2.0.0-SNAPSHOT.96and regenerate thepom.xmlanddependencies.mdreports.