Skip to content

Add the proofread skill and sweep repository prose - #143

Merged
Oleg-Melnik merged 4 commits into
masterfrom
proofread-skill-and-prose-sweep
Jul 28, 2026
Merged

Add the proofread skill and sweep repository prose#143
Oleg-Melnik merged 4 commits into
masterfrom
proofread-skill-and-prose-sweep

Conversation

@Oleg-Melnik

@Oleg-Melnik Oleg-Melnik commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a proofread skill that corrects English grammar, punctuation, and
spelling 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

  • Add .agents/skills/proofread/ (SKILL.md, agents/openai.yaml) and the
    .claude/commands/proofread.md entry point. The skill runs in three modes:
    branch diff (default), all for a full sweep, or a path for a scoped sweep.
  • Add .agents/guidelines/english-style.md, the catalog that defines what
    counts as an error and, for each topic, when to leave an occurrence alone.
  • Add .agents/guidelines/project-owned-files.md, the boundary that keeps any
    sweep out of the config submodule and the files it distributes.
  • Index the skill in .agents/skills/README.md.
  • Update AGENTS.md to require pull request titles without a trailing period.

Prose sweep — 47 files

  • Restrictive which to that where the clause identifies its antecedent,
    leaving non-restrictive and preposition-governed uses alone (~45 places).
  • allows to <verb> to the gerund form required after allow without an
    object, for example allows to amend to allows amending (~20 places).
  • Subject-verb agreement, missing articles, one hyphenation, several double
    spaces, and one dialect outlier (behaviour to behavior in a file that is
    otherwise American).
  • Repair three editing artifacts: a duplicated word, a run-together token, and
    a clause left fused to its replacement.
  • Refresh the copyright year to 2026 on every file touched, per AGENTS.md.

Version

  • Bump chordsVersion to 2.0.0-SNAPSHOT.96 and regenerate the pom.xml and
    dependencies.md reports.

Oleg-Melnik and others added 3 commits July 28, 2026 14:19
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>
@Oleg-Melnik Oleg-Melnik self-assigned this Jul 28, 2026
@Oleg-Melnik Oleg-Melnik changed the title Add the proofread skill and sweep repository prose. Add the proofread skill and sweep repository prose Jul 28, 2026
@Oleg-Melnik
Oleg-Melnik marked this pull request as ready for review July 28, 2026 11:54
@Oleg-Melnik
Oleg-Melnik requested review from armiol and dpikhulya July 28, 2026 11:54
@Oleg-Melnik
Oleg-Melnik merged commit 8176862 into master Jul 28, 2026
5 checks passed
@Oleg-Melnik
Oleg-Melnik deleted the proofread-skill-and-prose-sweep branch July 28, 2026 12:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants