gitwtfhub

wtf is clean-writing?

pastasaurusrex/clean-writing — explained in plain English

Analysis updated 2026-05-18

1Audience · writerComplexity · 1/5LicenseSetup · easy

TL;DR

A Claude Code and Claude Desktop skill that makes the AI write in one consistent house style using Canadian, personal, and Google style rules.

Mindmap

mindmap
  root((Clean Writing))
    What it does
      Sets Claude house style
      Merges three style layers
      Applies automatically
    Style sources
      Canadian conventions
      Author rulings
      Google style guide
    Use cases
      Write consistent docs
      Revise drafts in house style
      Format code in prose
    Audience
      Writers
      Vibe coders
      Claude Code users

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

Make Claude write documents, READMEs, and emails in one consistent house style

REASON 2

Apply Canadian conventions for dates, spelling, and money automatically

REASON 3

Revise an existing draft to match a mix of plain English and Google's documentation style

REASON 4

Install a portable writing style skill across every Claude Code project

What's in the stack?

Claude CodeClaude DesktopMarkdown

How it stacks up

pastasaurusrex/clean-writing0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultyeasyhardhard
Complexity1/54/55/5
Audiencewriterdeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installs with a single command via the community skills tool or a direct git clone into the skills folder.

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

Wtf does this do

Clean writing is a skill for Claude Code and Claude Desktop that teaches the AI assistant to write and revise prose in one consistent house style, instead of whatever style it would normally default to. It is a folder of markdown instructions that Claude reads automatically before drafting or editing documents, READMEs, emails, or pull request descriptions. The skill combines three separate sources of guidance. The first is Canadian conventions for things like money, dates, times, spelling, and number ranges. The second is a set of the author's own personal style rules, such as never using dashes, allowing negative contractions, and using the Oxford comma. The third is the complete Google developer documentation style guide, which the author gathered in full and organized into reference files covering tone, grammar, punctuation, formatting, and how to describe code within prose. When these three sources disagree with each other, Canadian convention takes priority first, followed by the author's own rulings, with Google's guidance filling in whatever is left. The project explains that each of these three layers alone leaves gaps. Plain, simple writing alone does not say how to format a table or punctuate a list. A detailed style guide alone often reads in a dense, bureaucratic voice. And regional convention alone only settles small details like date formats and spelling, not sentence structure or tone. Installing the skill can be done in three ways: through a community tool called skills, which automatically fetches and places public GitHub skills into the correct folder, by cloning the repository directly into a personal or project specific Claude Code skills folder, or by adding it through Claude Desktop's built in Skills panel using its GitHub path. Once installed, the skill applies automatically whenever Claude is asked to write, though it can also be triggered directly by name. It is released under the MIT license.

Yoink these prompts

Prompt 1
Install the clean-writing skill into my personal Claude Code skills folder.
Prompt 2
Rewrite this draft announcement using the clean-writing house style.
Prompt 3
Explain how clean-writing decides which style rule wins when Google and Canadian convention disagree.
Prompt 4
Show me how to invoke the clean-writing skill directly on a specific file.

Frequently asked questions

wtf is clean-writing?

A Claude Code and Claude Desktop skill that makes the AI write in one consistent house style using Canadian, personal, and Google style rules.

What license does clean-writing use?

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

How hard is clean-writing to set up?

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

Who is clean-writing for?

Mainly writer.

View the repo → Decode another repo

This repo across BitVibe Labs

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