mrkeyoor.com_
Wed 04 Nov 03:44 UTC
Dev Toolsevaluationupdated 04 Nov 2026

SimpleEnglish review

SimpleEnglish is an agent writing skill with plain-English rules drawn from Simplified Technical English. Its Claude Code and Codex plugins load writing rules at session start. The project does not provide STE-certified output.

Verdict

Consider SimpleEnglish for agent-written technical instructions if its restrictive reply style fits your workflow. The sandbox measured installation of the hook subproject, not plugin operation or writing quality. Claude Code's checks are advisory, Codex only loads session rules, and factual fidelity still needs review.

We ran it

Lab card: what happened when we ran SimpleEnglishScreenshot of SimpleEnglish (github.com/AminBlg/SimpleEnglish)
Install✓ · 2s0 packages · 1 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo958 files~2,532 lines of source · 1.2 MB · 1 CI workflows

Answers from our run

Does SimpleEnglish build from source?

Dependencies installed in 2 seconds (0 packages), and the project has no separate build step. We cloned commit a6fcb4f into a clean Debian container with 3 CPUs and no project-specific setup.

Does SimpleEnglish have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does SimpleEnglish have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use SimpleEnglish?

Teams requiring STE-certified output.

What are the alternatives to SimpleEnglish?

Vale, Proselint. Consider SimpleEnglish for agent-written technical instructions if its restrictive reply style fits your workflow.

SetupN/AThe hook-subproject install succeeded, but supported plugin setup and live activation were not validated.
DocsN/ASupplied integration instructions were inspected, but their operational accuracy was not validated in a live agent session.
CommunityN/AThe supplied issue sample documents user reports, but it does not establish maintainer responsiveness or resolution quality.
MaturityN/ADocumented tests were not run, and plugin reliability and factual fidelity of rewritten instructions remain unassessed.

Who it’s for

Technical writers using agents for runbooks, READMEs and instructions that need consistent terms.
Claude Code users who want session loading and advisory writing checks.
Codex users who want session loading and can review the documented hook.

Who it’s NOT for

Teams requiring STE-certified output.
Users who need headings, bullets or tables in chat replies: the documented reply rules prohibit them.
Teams requiring blocking enforcement: Claude Code's additional checks are advisory, and Codex runs only the SessionStart hook.
Writers who want contractions in chat replies.

Setup reality

The sandbox npm install succeeded in 2 seconds at commit a6fcb4f on 2026-11-03, recording zero dependencies and 1 MB for the project detected in src/hooks/. Npm audit reported zero known vulnerabilities. The harness found no automatic build or test target and skipped both steps. The hook README nevertheless documents runnable Node.js and Python checks; neither documented command was run.

The SessionStart hook uses Node.js. Claude Code's additional file and reply checks use Python scripts. This run did not validate plugin activation, advisory-check execution or their runtime requirements. The sandbox configuration recorded 3 CPUs, 8 GB RAM and image label lab-node:22; actual runtime versions were not verified.

Choose the skill or the session integration

SimpleEnglish's skills-CLI route installs writing instructions without the session hook or Claude Code output style. The plugins add session loading. Choose the route according to how broadly you want the rules applied, then verify that the intended instructions loaded.

The README describes two modes. Plain mode uses direct answers, active voice and sentence-length limits. Strict mode adds STE vocabulary discipline when requested. These rules make the skill a candidate for technical instructions whose terms and conditions need to remain consistent. Our sandbox did not assess whether its rewrites preserve meaning.

The reply rules prohibit headings, bullets, bold, tables and contractions. Try those restrictions on representative chat tasks before enabling session-wide loading. The document rules form a separate register for READMEs, runbooks and other technical writing.

What happened when we ran it

Our sandbox's npm install succeeded in 2 seconds on 2026-11-03 at commit a6fcb4f, recording zero dependencies and 1 MB on disk. The detected Node project was under src/hooks/. The harness discovered no automatic build or test target, so it skipped both steps.

That discovery does not mean the repository has no runnable tests. The hook README documents these commands from the repository root:

node --test src/hooks/simple-english-activate.test.js
python3 src/hooks/test_lint_hook.py

Neither command was run in our sandbox. They are documented checks, not passing results from this review.

The checkout scan recorded 958 files, about 2,532 source lines and 1.2 MB. It found one CI workflow file, no Dockerfile and no tests directory. The documented test files show why a directory scan cannot establish the absence of checks.

Npm audit reported zero known vulnerabilities, with zero critical, high, moderate or low findings. That result covers the recorded Node audit, not writing quality or the complete agent workflow. The zero-dependency observation applies to the detected hook subproject.

The sandbox configuration recorded 3 CPUs, 8 GB RAM and image label lab-node:22. The image label does not verify a Node or operating-system version. This run did not validate a live plugin session, execute the advisory checks or assess an agent writing sample.

Session loading and writing checks use different runtimes

The SessionStart hook uses Node.js in both Claude Code and Codex. It sends a condensed rule block and names the full skill path. If it cannot read the prompt file from any expected location, it prints fallback rules and exits successfully. A successful session start therefore does not prove that the intended prompt file loaded.

Claude Code's additional file and reply checks use Python scripts and are advisory; neither blocks. The hook documentation identifies src/hooks/lint_hook.py for both checks and evals/ste_lint.py for Markdown linting. Codex runs only the SessionStart hook. Our run did not validate the Python checks' execution or runtime requirements, and the supplied evidence does not establish a required Python version.

For Claude Code, the README specifies the output-style name simple-english:simple-english and says the short name does not resolve. Codex asks users to review and trust the hook before its first run. These configuration steps were not validated by our npm installation.

The v2.1.1 report measures formatting

The October 5 report includes a condition using the rule block from tag v2.1.1. This contradicts the README's statement that no reply run exists for 2.1.0 or later. The README's historical 2.0.1 figures should not be presented as measurements of v2.1.1.

The report also distinguishes a bare rule block from the same instructions with the page header attached. That distinction matters when reproducing the upstream setup or choosing what to paste into an agent.

The upstream scorer counts formatting only and cannot detect facts added or dropped from replies. These evaluations are separate from our sandbox. They do not establish factual fidelity or reader comprehension. Compare a rewritten instruction with its source, especially prerequisites, conditions and exceptions.

The README says the project does not provide STE-certified output and identifies it as unofficial. Teams requiring compliance approval need a separate review process.

Check the reported Windows limitation before relying on warnings

The supplied open-issue sample includes issue #51, an unverified user report that the Stop hook produces false dash warnings on Windows for replies containing non-ASCII text. The reporter names plugin 2.1.1. We did not reproduce the report or verify its proposed cause or fix. Windows users should include representative non-ASCII replies when checking the integration.

Alternatives for checking existing prose

Vale is a command-line prose linter that turns writing guidelines into checks. Consider it when you want explicit checks in documentation workflows rather than relying on an agent to follow writing instructions.

Proselint scans existing prose and prints suggestions. Consider it when that checking workflow fits your needs without session-wide writing instructions. Neither alternative was tested in this sandbox, and this comparison does not establish better rewrite quality.

For a SimpleEnglish trial, choose a document whose meaning you can verify. Confirm session loading, run the documented checks in your environment and compare the rewritten document with its source before adopting the rules more broadly.

Alternatives

ProjectWhat it isPick it when
ValeA command-line prose linter that turns writing guidelines into checks.Consider it when you need explicit checks in documentation workflows rather than session-wide agent writing instructions.
ProselintA linter that scans English prose and prints suggestions.Consider it when you want suggestions on existing text without loading writing instructions into an agent session.

What people are saying

  1. [github-trending] AminBlg/SimpleEnglish

Sources

  1. SimpleEnglish README
  2. Session and advisory hooks
  3. October reply evaluation
  4. Vale README
  5. Proselint README
  6. SimpleEnglish issue activity

More dev tools reviews

QuickLook · kero · CalibRaw · ava · hiddify-app · betterleaks · the whole board →