/jev-prose

name: jev-prose
description: >-
  Check prose with Jev for narrow AI-writing patterns and revise from its
  feedback. Use when asked for Jev prose checks, AI-pattern cleanup, or an
  ongoing check-and-rewrite loop while writing sentences or paragraphs.

Jev prose check and revision

Use the `jev-prose` CLI to get independent, probabilistic editorial feedback. It checks patterns, not authorship. The writer makes the editorial decisions.

Setup

Run `jev-prose --help` to check availability. From a claude-code-tools checkout, install with `uv tool install ./packages/jev-prose`. The package carries the persistent question bank; no global skill source paths are needed at runtime. If no checkout or installed CLI is available, report that prerequisite rather than substituting self-review for a Jev result.

Default authentication is `CLOUDFLARE_ACCOUNT_ID` and `CLOUDFLARE_API_TOKEN`, or an existing sysone account configuration and Wrangler login. The backend is hosted Jev; the text and optional context are sent there. A configured alternative can be selected with `--backend typesafe` or `--url` and `--model`. Do not print secrets. An authentication or billing failure stops the loop.

Bounded loop

For each requested sentence, paragraph, or short section:

1. Save the exact draft in a temporary UTF-8 file. Keep the original and track the revision count (initial draft is attempt 0). Preserve the user's intended facts, names, numbers, citations, caveats, voice, and literal quotations. 2. Run `jev-prose check draft.txt --profile general > report.json`. For papers, specifications, and formal technical prose use `--profile formal`. Use `strict` only when requested; it adds personal editorial preferences. Optional `--audience`, `--voice`, and `--context context.txt` help avoid false positives. Keep these settings and the threshold fixed throughout the loop. 3. Read the report even when the command exits 1: that means findings, not a failed call. Require `ran: true`, `ok: true`, and `answered == expected`. Exit 2, missing output, malformed JSON, or an incomplete check stops the loop as an error; never label the draft clean in those cases. 4. If `status` is `clean`, stop. Otherwise inspect the flagged questions and guidance against the actual draft. A high probability is not a command to edit: dismiss an inapplicable flag with a brief reason. Jev provides no evidence spans; locate the passage yourself without pretending it supplied an exact quote. Combine overlapping findings into one targeted revision. 5. If no useful revision follows, stop and disclose the unresolved or dismissed flags. Otherwise revise only the affected prose, increment the attempt count, and return to step 2. Allow at most **three revisions and four checks total**. Stop earlier if text repeats or feedback cycles without useful improvement. Always check the last revision; never end on an unchecked rewrite.

Preserve substantive claims as well as individual facts. If addressing a finding would weaken, strengthen, remove, or otherwise change a conclusion, leave the claim intact and report the finding unresolved unless the user has authorized factual or argument changes. An unsupported claim is not permission to silently replace the author's intended claim with a different one.

Do not change thresholds to obtain a clean result. Do not add invented examples, anecdotes, feelings, measurements, sources, or stronger claims. Do not remove necessary qualifications or factual content to lower the number of flags. Check meaning against the original after each revision; undo any harmful edit.

A sentence check cannot establish document-level structure. If asked to use this while writing a document, check each completed paragraph and then the finished short section for repetition. Respect the 24,000-character input limit; do not silently truncate. This workflow runs when invoked; it installs no automatic hook.

Return the revised prose in the requested form. Briefly report the number of revisions, check outcome, and any unresolved/dismissed findings. If every finding was dismissed, say that explicitly instead of reporting a model-clean result. Keep detector reports out of published prose unless requested.