mrkeyoor.com_
Thu 01 Oct 08:14 UTC
LLM Toolsevaluationupdated 01 Oct 2026

claude-style-patch review

Claude Style Patch is a prose rulebook meant to be appended to `CLAUDE.md` or pasted into Claude custom instructions. It targets dense sentences, announced points, vague antecedents, stock endings, and other habits that make generated writing harder to read.

Verdict

commit b62aa1b gave our lab no executable path to test, so Claude Style Patch is best judged as a three-file editorial policy, not software. Its diagnoses are specific enough to borrow, especially the rules on announced points and compressed sentences. Adopt selected rules in a project file first; use Vale when a style requirement must be enforced rather than merely requested.

We ran it

Screenshot of claude-style-patch (github.com/andrewroxby/claude-style-patch)

Answers from our run

Did you run claude-style-patch yourself?

No. GitHub reports no primary language for it, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use claude-style-patch?

Teams seeking an executable formatter or pass/fail linter: the repository contains prose instructions, not a checker.

What are the alternatives to claude-style-patch?

Humanizer, Vale, write-good. commit b62aa1b gave our lab no executable path to test, so Claude Style Patch is best judged as a three-file editorial policy, not software.

Setup4/5One append command, but repeat runs duplicate the entire patch
Docs4/5Purpose, scope, caveats, and placement are clear
Community2/5148 stars, 7 forks, and no substantive issue discussion
Maturity2/5No releases, changelog, tests, or published evaluation corpus

Who it’s for

Claude Code users who dislike dense, abstract answers and want one editable house-style block.
Teams willing to review a 1,500-word instruction file and adapt it to their own genre.
Writers who understand that prompt instructions influence output but do not guarantee compliance.
Developers who want CC0 text they can copy, cut, and maintain inside an existing CLAUDE.md.

Who it’s NOT for

Teams seeking an executable formatter or pass/fail linter: the repository contains prose instructions, not a checker.
Projects with strict existing voice rules that conflict with short declaratives, limited colon use, or the guide's document format preferences.
Users short on instruction context: the README puts the patch at roughly 1,500 words, loaded before the actual task.
Anyone expecting measured before-and-after evidence: the README reports the author's experience but publishes no corpus, rubric, comparison, or reproducible evaluation.
Users who plan to rerun the install command blindly: it appends with >>, so each rerun adds another full copy instead of updating the first one.

Setup reality

Our lab did not run commit b62aa1b because the repository declares no supported language ecosystem and has no Dockerfile. It is a text artifact rather than an executable package, so there is no measured install, build, or test result.

Setup means reviewing STYLE.md, then appending it to a global or project CLAUDE.md. It needs no credential or service. The documented curl command is easy, but it has no duplicate check, version marker, update path, or uninstall command.

The repository contains only README.md, STYLE.md, and a CC0 license. Compliance depends on the selected Claude model, the rest of the instruction stack, thread length, and the task's genre.

The useful part is the diagnosis, not the install command

Claude Style Patch starts from recognizable writing failures. It calls out sentences that announce a point before making it, paragraph-opening fragments, unclear pronouns, abstract nouns where verbs would be clearer, and several compressed ideas packed together. Those are concrete editing targets. A team can discuss whether a response has an unclear antecedent; it cannot do much with a vague request to sound better.

The artifact is one STYLE.md file of 9,739 bytes, plus a README and 211-byte CC0 license. The README estimates the instructions at roughly 1,500 words. That is long enough to shape a session and long enough to compete with project rules, task context, and retrieved files. Read all of it before placing it in a global config that affects every Claude Code repository.

The rules favor plain sentences and restrained structure

The guide asks Claude to use concrete nouns, active verbs, clear antecedents, and natural transitions. It discourages colon-hinged clauses, ornamental endings, repeated summaries, and metaphors left unexplained. For documents, it favors scannable headers, short bullets, and tables for direct comparison. Code comments should describe current behavior instead of recording abandoned approaches.

These choices form a real editorial taste, not a neutral quality standard. The file prefers mostly short declaratives and even recommends a numbered hierarchy for complex responses. That can help design notes and technical explanations. It may flatten a personal essay, marketing page, legal memo, or support conversation. The patch partly handles this by telling Claude to honor the target genre before applying its defaults.

What happened when we ran it

commit b62aa1b exposed no supported language ecosystem and no Dockerfile, so the lab had no install, build, or test command to execute. This is expected for a repository containing three text files. There is no binary, package manifest, hook, or test harness whose output could show that the rules improve prose.

That leaves a different verification job. Copy the file into a temporary project, choose a fixed set of real prompts, and compare blind reviews of output with and without the patch. A useful check would score clarity, factual retention, fit to genre, and editing time. The repository provides no such corpus or rubric, so claims about improved output remain the author's experience rather than a result another team can reproduce.

The append command is simple but not idempotent

The documented installation pipes raw STYLE.md into ~/.claude/CLAUDE.md with >>. It needs no account and takes one shell command. It also appends another copy every time it runs. There is no start marker, end marker, version number, duplicate check, backup, or removal command. A repeated setup can silently make the instruction stack longer and more contradictory.

A safer manual adoption is to download or open STYLE.md, select the rules your team agrees with, and place them under a named project section. Commit that project file so changes receive code review. For a global installation, add clear markers around the block and keep a source commit beside them. Updating then becomes replacing one known section rather than appending 1,500 more words.

Hard style rules can create new verbal tics

The README gives a good warning from the author's own use. An earlier rule discouraged common connectives and named 'so' as an alternative, after which Claude began opening many inferential sentences with that word. The current patch reframes its guidance as defaults applied with judgment. It also acknowledges that compliance drops in long, abstract threads and suggests reminding Claude to follow the style rules closely.

The file still contains tensions worth editing locally. It warns against dense wording while using terms such as 'nominalizations,' 'antecedents,' and 'Tractatus numbering.' It discourages colon-heavy construction but relies on detailed exceptions. There are also small copy errors, including 'antetheses' and 'its not.' None ruins the idea. They do show why copying an editorial policy should begin with an editorial pass.

Deterministic linting covers the rules that must hold

Prompt instructions can influence a first draft. They cannot certify that a final document obeys a rule, especially when the README itself says long threads degrade compliance. If your team merely prefers fewer announced points or clearer pronouns, that uncertainty may be acceptable. If documentation cannot ship with banned terms, passive constructions, or an invalid heading pattern, add a checker.

Vale is the stronger alternative for team policy because its rules can fail locally and in CI. Humanizer fits a separate rewrite step with a broader list of AI-writing habits. Claude Style Patch is most useful between those approaches: a permissively licensed source of precise editorial preferences. Start with the 4 or 5 rules that solve problems your team has actually seen, then add more only when reviewed output justifies their context cost.

September activity shows a new, lightly discussed project

The repository was created on September 8, 2026 and pushed on September 28. GitHub showed 148 stars, 7 forks, and no open issues or pull requests on October 1. Its two closed issues were automated promotion or listing notices rather than user reports. There are no GitHub releases or changelog.

That record is enough for a copyable CC0 document, but not evidence of broad model testing. The README says the current text was tuned for Opus 5.5 after earlier use with Opus 4.8 and Fable. Model behavior changes, so keep the patch in normal review like any other prompt dependency. The right unit of adoption is a rule you can defend, not a file you appended once and forgot.

Alternatives

ProjectWhat it isPick it when
Humanizer gh↗A rewrite skill with a larger catalog of common AI-writing patterns and an explicit editing process.pick this instead when you want a post-draft rewrite pass rather than standing style instructions.
ValeA programmable prose linter that reports rule violations in files and CI.pick this instead when style requirements must produce repeatable, reviewable failures.
write-goodA lightweight command-line linter for weak wording and common prose problems.pick this instead when you need a quick deterministic check without changing the model prompt.

What people are saying

  1. [velocity-scout] andrewroxby/claude-style-patch

Sources

  1. Claude Style Patch README
  2. Claude Style Patch rules
  3. Claude Style Patch CC0 license

More llm tools reviews

agent-toolkit-for-aws · agent-memory · codex-astra-luna-orchestrator · okf-agent-memory · mlc-llm · awesome-openclaw-skills · the whole board →