write-simply
Skill9 starsChanged 2 months agoApache-2.0View on GitHub
Writing or editing prose humans read - docs, commit messages, error messages, reports, UI text. Also the register other skills invoke for compact technical prose (docstrings, comments, captions, proposals), and the pass that makes text sound human instead of AI-written ("humanize", "reads like ChatGPT").
In this repository60 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- check-for-updatesSkill
- api-designSkill
- bddSkill
- blueprintSkill
- brainstormingSkill
- browser-usageSkill
- clarify-codeSkill
- cleanupSkill
- codebase-designSkill
- code-contractsSkill
- code-reviewSkill
- commitSkill
- confluence-exportSkill
- database-proSkill
- datadogSkill
- diagnosing-bugsSkill
- diagram-designSkill
- e2e-testSkill
- explain-code-flowSkill
- explain-simplySkill
- frontend-slidesSkill
- glabSkill
- grill-meSkill
- handoffSkill
- herdrSkill
- i-have-adhdSkill
- impeccableSkill
- implementSkill
- improve-codebase-architectureSkill
- jiraSkill
- loomSkill
- markitdownSkill
- mermaid-skillSkill
- modularity-designSkill
- modularity-reviewSkill
- plannotatorSkill
- ponytailSkill
- prototypeSkill
- qmdSkill
- refactorSkill
- releaseSkill
- researchSkill
- security-reviewSkill
- show-meSkill
- skill-doctorSkill
- stop-the-slopSkill
- tddSkill
- teachSkill
- terraform-engineerSkill
- ticket-overviewSkill
- to-specSkill
- to-ticketsSkill
- update-docstringsSkill
- wayfinderSkill
- write-documentationSkill
- write-readmeSkill
- writing-for-agentsSkill
- wtfSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Always use ASD-STE100 Simplified Technical English plus Zinsser's four principles Write vigorous prose: every word tells, sentences are …
- Distinctive: line 9
Write vigorous prose: every word tells, sentences are active and concrete, needless words are gone.
- Distinctive: line 16
Use the active voice.
- Distinctive: line 17
Put statements in positive form.
- Distinctive: line 18
Use definite, specific, concrete language.
- Distinctive: line 21
Place emphatic words at the end of the sentence.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Write Simply
Always use ASD-STE100 Simplified Technical English plus Zinsser's four principles Write vigorous prose: every word tells, sentences are active and concrete, needless words are gone. Say what the thing does, in the words a knowledgeable human would pick.
Principles
Strunk's principles of composition, applied to everything you write:
- One paragraph per topic; open it with a topic sentence.
- Use the active voice.
- Put statements in positive form.
- Use definite, specific, concrete language.
- Omit needless words.
- Express co-ordinate ideas in similar form; keep related words together.
- Place emphatic words at the end of the sentence.
Register for compact prose
Docstrings, comments, commit messages, captions, a numbered list of proposals: ASD-STE100 Simplified Technical English plus Zinsser's four principles — clarity, simplicity, brevity, humanity. On top of the principles above:
- One idea per sentence; about 20 words or fewer.
- One meaning per word; the same word for the same thing every time.
- Simple present tense; instructions as imperatives.
- Plain words; name the specific thing.
- One person talking to another.
A skill that says "use the register" means this section; nothing further to load.
What to load
Match the task to one row and load exactly that file:
| Task | Load |
| Writing or editing paragraphs, docs, explanations | references/elements-of-style/03-elementary-principles-of-composition.md |
| Fixing grammar, commas, punctuation in existing text | references/elements-of-style/02-elementary-rules-of-usage.md |
| Choosing the right word, fixing common misuses | references/elements-of-style/05-words-and-expressions-commonly-misused.md |
| Headings, quotations, formatting | references/elements-of-style/04-a-few-matters-of-form.md |
| load this always | references/humanizer.md |
| Spotting AI patterns while writing (words to watch) | references/ai-patterns.md |
| Auditing whether text is AI-written (full catalogue) | references/signs-of-ai-writing.md |
Full pass — load 02, 03, 04, 05, humanizer.md, and ai-patterns.md together — only when the user asks for a substantial new piece ("write the docs", "draft the README") or names the depth ("full pass", "thorough edit", "load everything"). "Fix this paragraph" stays with one file.
Done means
Re-read the full output. It is done when every sentence passes:
- each word informs;
- the active voice wherever it works;
- a specific where a generic stood;
- the human's word where an AI pattern stood (puffery, promotional adjectives, "delve"/"leverage", decorative formatting).
A failed sentence is fixed, then the whole output is re-read again.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

