explaingit

pencil20388-eng/stop-slop-zh

14Audience · writerComplexity · 1/5LicenseSetup · easy

TLDR

A writing rule set you load into AI coding tools to stop them from producing robotic-sounding Chinese text, replacing filler phrases and stiff structure with natural, conversational language.

Mindmap

mindmap
  root((stop-slop-zh))
    What it does
      Ban filler phrases
      Fix punctuation habits
      Enforce natural tone
    Content
      SKILL.md rules
      Banned word list
      Colloquial replacements
      Before/after examples
    Quality checks
      Punctuation rules
      Style review
      Concrete detail check
      Human-sounding test
    Tools supported
      Claude Code
      Cursor
      Codex CLI
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Load this skill into Claude Code or Cursor to automatically clean up AI-generated Chinese prose before publishing.

USE CASE 2

Use the banned phrase list as a manual checklist when editing your own Chinese writing for natural tone.

USE CASE 3

Run the four-layer quality check on a draft to get a structured report on where the text still sounds machine-written.

USE CASE 4

Clone the project as a starting template and customize the banned/approved word lists for your own writing style guide.

Getting it running

Difficulty · easy Time to first run · 5min

Install by cloning into your AI tool's skills directory, no dependencies required.

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

In plain English

Stop Slop ZH is a writing rule set designed to remove the patterns that make AI-generated Chinese text feel machine-written. It is not a standalone application, but a skill file that you load into AI tools like Claude Code, Cursor, or Codex CLI to change how they generate Chinese prose. Chinese AI writing tends to fall into recognizable patterns: connecting phrases like "it is worth noting that" or "in summary," numbered list structures, heavy use of colons and double quotes, and a formal newsreader tone. This project identifies those patterns and instructs the AI to avoid them, replacing them with more conversational and specific language that sounds like a person writing from direct experience. The project consists of a main instruction file (SKILL.md) and a set of reference files. The reference files catalog over 30 banned filler phrases, banned punctuation marks, banned structural patterns (such as first/second/third enumerations), and a library of over 50 recommended colloquial Chinese expressions to use instead. There is also a before/after example file showing the difference between typical AI output and the revised version. When the AI finishes writing or revising text, it runs a four-layer quality check: verifying hard punctuation and word rules, reviewing style, checking whether the content has enough concrete detail, and assessing whether the text reads like a person rather than a machine. It produces a short report after each check. Installation is a single git clone into your AI tool's skills directory. The project is MIT licensed and was built by a content team that uses the same rules in their own daily Chinese writing work.

Copy-paste prompts

Prompt 1
I'm using Claude Code to write Chinese blog posts but they sound like a machine. Show me exactly how to install stop-slop-zh as a skill so every generated draft automatically avoids filler phrases.
Prompt 2
Here is a paragraph of AI-generated Chinese text. Apply the stop-slop-zh rules to rewrite it so it sounds like a real person writing from experience: [paste text].
Prompt 3
Using the stop-slop-zh banned phrase list, write a VSCode snippet or linter rule that highlights these phrases in a Chinese document as I type.
Prompt 4
I want to build a similar rule set for Japanese AI writing. Use stop-slop-zh's structure as a template and suggest 10 common Japanese AI filler patterns to ban.
Open on GitHub → Explain another repo

← pencil20388-eng on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.