plain-english

Installation
SKILL.md

Plain English

The reader gets one pass, cold, with nothing else open and nobody to ask. Every rule below buys clarity on that pass.

These are the rules to write toward. deslop-written is the pass that strips AI tells out afterwards. Write with this one, check with that one.

Where this applies

Any prose a person reads: code comments and docstrings, commit messages, ticket bodies, PR descriptions, READMEs, docs, chat replies, error and UI strings. Comments count. They are documentation that happens to live in a source file, and they go stale the same way.

1. Second person, active voice

Address the reader as you. Name whoever performs the action.

Installs
6
GitHub Stars
2
First Seen
Sep 25, 2026