gitwtfhub

wtf is write-better?

plannotator/write-better — explained in plain English

Analysis updated 2026-05-18

19Audience · developerComplexity · 1/5LicenseSetup · easy

TL;DR

A shared agent skill that rewrites prose to be clearer, more direct, and less like generic AI writing.

Mindmap

mindmap
  root((repo))
    What it does
      Clearer prose
      Sounds natural
      Keeps author voice
    Tech stack
      Markdown skill file
      Claude Code plugin
      Codex plugin
    Use cases
      Editing documentation
      Reviewing reports
      Rewriting interface copy
    Audience
      Agent developers
      Technical writers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Install a shared writing skill so an AI agent's docs and messages read naturally instead of in a generic AI voice.

REASON 2

Invoke write-better to revise an existing report or explanation for clarity and tone.

REASON 3

Add write-better as a Claude Code or Codex plugin so every agent session can use the same writing guidance.

What's in the stack?

Markdown

How it stacks up

plannotator/write-better16nic/comfyui-agnes-ai521xueweihan/hgdoll
Stars191919
LanguagePythonKotlin
Setup difficultyeasymoderatehard
Complexity1/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

write-better is a skill that agents like Claude Code or Codex can install to help them write clearer, more direct prose that reads naturally, rather than in a stiff or generic AI voice. It is meant to apply broadly, covering new drafts as well as edits to documentation, workplace messages, essays, reports, explanations, and the short copy used inside an app's interface. Once installed, a user or agent invokes it by name, using the command write-better, whenever they want an AI agent to draft, rewrite, edit, or review a piece of writing for clarity, usefulness, tone, and a natural human sounding voice. The goal stated in the README is prose that does not invent facts and does not flatten the author's own voice into something generic. The guidance behind the skill draws on ideas from what the author calls the Humanizer pattern catalog, along with Wikipedia's page describing common signs of AI generated writing, using both as reference points for what to avoid. Installation is done through the skills command line tool with npx skills add plannotator/write-better, and the README notes you can list the available skill before installing it. There are also dedicated installation paths for Claude Code, added as a plugin marketplace entry, and for Codex, using its own plugin marketplace command. The project is released under the MIT license. Beyond the install commands and this general description, the README does not go into further detail about how the skill's internal rules are structured or what specific rewriting techniques it applies.

Yoink these prompts

Prompt 1
Install plannotator/write-better as a Claude Code plugin and use it to rewrite this paragraph.
Prompt 2
Invoke write-better on this README draft to make it sound more natural and less like generic AI writing.
Prompt 3
List what plannotator/write-better actually checks for before I install it.

Frequently asked questions

wtf is write-better?

A shared agent skill that rewrites prose to be clearer, more direct, and less like generic AI writing.

What license does write-better use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is write-better to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is write-better for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.