mrkeyoor.com_
Mon 07 Sept 15:57 UTC
AI Toolsevaluationupdated 07 Sept 2026

sepia review

Sepia is a writing skill for AI coding agents that diagnoses or rewrites prose using separate rules for fiction and workplace documents. It tries to fix story structure, repetitive paragraph patterns, and venue mistakes before polishing individual sentences.

Verdict

Our sandbox could not run Sepia at commit 361e82e because it found no supported ecosystem and no Dockerfile, so the evidence is the published rule set rather than an executable result. Use it if you want an agent editor with separate fiction and workplace routes and you are prepared to review its judgments. Choose a conventional prose linter when repeatable rules and CI enforcement matter more than broad rewrites.

We ran it

Screenshot of sepia (github.com/Nanako0129/sepia)

Answers from our run

Did you run sepia 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 sepia?

Buyers who need measured proof that the skill improves writing: the README calls its voice-composition example a single blind-review experiment, and v0.8.0 says the new deletion and reversion tests are untested as an intervention.

What are the alternatives to sepia?

Humanizer, LanguageTool, Vale. Use it if you want an agent editor with separate fiction and workplace routes and you are prepared to review its judgments.

Setup3/5Install commands are clear; our harness had no runnable target
Docs4/5Routes, packaging, evidence limits, and uninstall steps are explicit
Community3/52,384 stars, but the repository is only days old
Maturity2/5v0.8.0 is active, with cross-platform behavior still untested

Who it’s for

Writers who already use Claude Code, Codex, Grok Build, Antigravity, or another Agent Skills client.
Editors who want review-only and minimal-edit modes alongside a full rewrite option.
Teams willing to inspect a long, research-linked rule set and decide which judgments fit their house style.
Fiction writers who care about plot shape and narrator habits as much as word choice.

Who it’s NOT for

Buyers who need measured proof that the skill improves writing: the README calls its voice-composition example a single blind-review experiment, and v0.8.0 says the new deletion and reversion tests are untested as an intervention.
Anyone expecting guaranteed detector evasion: the project explicitly says it writes for expert readers and is tuned to pass no automated detector.
Teams that need identical behavior across every advertised client: installation was exercised on four named platforms, while runtime behavior was not checked platform by platform and the other Skills CLI targets were not exercised by the maintainer.
Users who want one standalone operation wrapper: the README says those wrappers depend on the sibling canonical skill and are unsupported by themselves.

Setup reality

We did not run Sepia in our 2026-08-31 sandbox. At commit 361e82e, the harness found no supported software ecosystem and no Dockerfile, so there was no install, build, or test command it could execute.

Sepia itself needs no hosted account or project secret. Installation goes through the Skills CLI or a native plugin command for Claude Code, Codex, Grok Build, or Antigravity; a project-scoped copy can also live under the agent's skill directory.

The main gotcha is what "verified" means here. The README says the native installs completed and their entries appeared, but their documented behavior was not exercised on each platform. Operation wrappers also need the full plugin package rather than a file copied alone.

Three passes put story structure ahead of word choice

Sepia's fiction route works in 3 passes: narrative architecture, discourse flow, then surface style. The first pass looks for explained themes, plots that resolve too neatly, narrow emotional description, sparse character networks, and endings built around acceptance. The next pass checks paragraph and sentence patterns. Familiar cleanup such as clichés and register comes last. That ordering is the project's main distinction from tools that swap vocabulary while leaving the story's shape intact.

The project also includes a 30-feature diagnosis rubric and model-specific fingerprints drawn from published vendor guidance and cited studies. It says those fingerprints apply only when the executing or writing model is known. Vendors without published guidance are recorded as consulted rather than assigned guessed traits. That restraint is useful, though every diagnosis still comes from instructions interpreted by a language model, so editors must decide whether a finding fits the passage in front of them.

Four operation modes set different editing boundaries

Four documented operations cover write, review, refactor, and recreate. Review reports problems without changing text. Refactor aims for minimal edits, while recreate permits a full rewrite from the source facts and intent. A fifth Hemingway entry applies the included voice profile to fiction writing or refactoring. These distinctions make Sepia easier to supervise than a single "humanize" command because the user chooses how much authority the agent receives before it touches the draft.

Professional prose uses 5 venue-specific overlays: release notes, pull request or issue replies, postmortems, tickets, and technical articles. The rules favor user impact in releases, file-and-line evidence in code review, timelines in incident reports, testable acceptance criteria in tickets, and a concrete problem in technical writing. This part is more practical than the fiction theory. It gives an agent a reason to treat a production incident differently from a blog post instead of applying one general ban list everywhere.

What happened when we ran it

Our 2026-08-31 measurement setup used a fresh unprivileged container with 3 CPUs and 8 GB of RAM. The sandbox did not run Sepia at commit 361e82e because it detected no supported ecosystem, and the checkout had no Dockerfile. There are therefore no measured install, build, test, dependency, timing, or vulnerability results for this project. That absence matters: the README's installation claims were not reproduced by our harness.

Sepia is mostly a collection of Markdown skills, reference files, research notes, packaging metadata, and evaluation material, so a package-manager build is not necessarily the right test. Even so, commit 361e82e supplied no target our sandbox knew how to execute. A useful adoption check is a before-and-after corpus from your own work, scored blind by editors who know the venue. The repository's badges and current test directory do not replace that local editorial test.

The evidence base is public, while intervention proof is limited

The Sepia README bases its fiction approach on StoryScope, a study covering 61,608 stories from humans and 5 frontier models. The project interprets that work as evidence that narrative structure can remain detectable after surface editing. Its research directory links the papers and separates measured findings from project inferences. Readers can follow the chain instead of accepting an unexplained checklist, which is a real advantage for a prompt-based editing tool.

The repository is equally direct about its limits. Voice-skill composition is described as experimental and grounded in 1 blind-review example rather than measured evidence. The v0.8.0 release notes say the new deletion and reversion tests are untested as an intervention. They also explain that an earlier content-word threshold was removed because a corpus-level effect could not justify a rule for one passage. That is sound editorial caution, though it leaves effectiveness for adopters to measure themselves.

Seventy-seven client targets do not mean verified behavior on 77 agents

The Skills CLI route advertises support for 77+ agents, while Sepia provides native plugin packaging for Claude Code, Codex, Grok Build, and Antigravity. The README narrows the claim: those 4 native installs were exercised only far enough to confirm installation and entry discovery. Runtime behavior was not checked platform by platform, and clients outside those four were not exercised by the maintainer. Teams should treat portability as a format claim, then verify prompt loading and file access in their chosen agent.

Installation has another sharp edge. The thin operation wrappers depend on the canonical sibling skill, so copying only sepia-review or sepia-refactor is unsupported. The full package keeps one canonical SKILL.md instead of separate platform forks, which reduces drift. Project-scoped users can commit the skill under .agents/skills or .claude/skills; user-scoped installs follow each client's plugin command. No hosted service or API credential is part of the documented path.

Version 0.8.0 is active, but age still limits the maturity case

GitHub records the repository's creation on August 28, 2026, its last push on September 5, and the v0.8.0 release on that same September date. It had 2,384 stars and 2 combined issues and pull requests when fetched. One open issue, issue 227, keeps automatic voice suggestions off professional routes until the report format has a closed vocabulary. That is specific, current maintenance activity, not proof of long-term stability.

Sepia is worth trying on copies of real drafts if its structural editing matches the problem you have. The 361e82e sandbox result cannot tell us whether it installs cleanly or produces better prose, and the project does not promise detector evasion. Its strongest case is narrower: clear editing modes, visible source material, and unusually frank limits around what has been verified. Keep a human editor responsible for the final judgment, especially when refactor or recreate can change meaning.

Alternatives

ProjectWhat it isPick it when
Humanizer gh↗A smaller Agent Skill focused on removing common signs of AI-written prose.pick this instead when sentence-level cleanup is the job and Sepia's fiction architecture system feels excessive.
LanguageToolAn established grammar and style checker with support for many human languages.pick this instead when spelling, grammar, and multilingual checking matter more than agent-specific rewriting.
ValeA configurable prose linter that applies explicit style rules to text and documentation.pick this instead when a team needs deterministic, reviewable lint rules in CI rather than an agent making editorial judgments.

What people are saying

  1. [velocity-scout] Nanako0129/sepia

Sources

  1. Sepia README
  2. Sepia v0.8.0 release notes
  3. Sepia issue 227: professional voice-fit report format
  4. Sepia research directory

More ai tools reviews

personaplex · feynman · rf-detr · AIHawk · peft · DeepSpeed · the whole board →