Installable writing skills for AI agents that need to sound like a careful writer, explain a procedure plainly, or check a draft for familiar AI prose signals. Choose the skill for the job in front of you; a mixed document does not need to pass through the whole suite.
The detector flags features only as a verb, so "three new features" and a
Features heading stay clean. The lookalike gate decides per sentence, which
stops Russian technical prose beside English terms from reading as a swap, and
the word tables now carry concrete alternatives where they used to say
"describe what changed".
The latest GitHub release is 2.12.13; the current source tree matches it.
See CHANGELOG.md for the full history.
| Need | Skill | Version |
|---|---|---|
| Preserve a writer's voice while removing stiff or generic prose | humanizer |
1.7.7 |
| Write procedures, errors, runbooks, and clear technical sections | simple-english |
2.4.2 |
| Scan for AI-writing signals or verify that an edit preserved structure | ai-writing-detector |
1.2.0 |
| Draft reader-facing prose with a deterministic Vale review gate | writing-prose |
1.2.3 |
| Pick the right register for an audience: three modes plus tone overlays | writing-voice |
1.1.0 |
Use one skill for the job a section needs.
- Rewrite without replacing the writer. Humanizer keeps facts, technical terms, uncertainty, point of view, and deliberate style while cutting filler.
- Control technical form when clarity is the priority. Simple English offers strict and STE-flavored modes plus a Python linter.
- Measure signals without making authorship claims. AI Writing Detector reports issue bands and can compare a before/after pair for damaged code, URLs, or structure.
- Pair editorial judgment with a repeatable gate. Writing Prose ships its Vale configuration, house rules, and long-form references with the skill.
- Match the audience. Writing Voice picks Chat, Human, or Worker, then optional tone overlays. It routes to Humanizer's voice-profile table and does not invent a personality the source never had.
Humanizer is a writing workflow rather than a command-line filter. Install the skill, then ask the agent to rewrite, clean up, critique, detect, or minimally edit supplied text. Improve the writing without inventing facts or a new personality.
Simple English includes a deterministic linter:
python3 skills/simple-english/scripts/voice_lint.py path/to/draft.mdAI Writing Detector exposes a zero-dependency Node.js scan and a preservation check:
node skills/ai-writing-detector/scripts/analyze.js path/to/file.md
node skills/ai-writing-detector/scripts/validate-cli.js before.md after.md
bash skills/ai-writing-detector/scripts/smoke.shWriting Prose runs the bundled Vale rules through one wrapper:
bash skills/writing-prose/scripts/vale-lint.sh path/to/draft.mdDetector output is signals_only. It is not proof of authorship and should not be used as a score to chase.
Each directory under skills/ is self-contained. Copy only the skill you need:
cp -R skills/humanizer ~/.claude/skills/Other supported skill directories include ~/.codex/skills/ and ~/.openclaw/skills/.
For a Hermes category layout:
mkdir -p ~/.hermes/skills/writing
cp -R skills/humanizer ~/.hermes/skills/writing/
cp -R skills/simple-english ~/.hermes/skills/writing/
cp -R skills/ai-writing-detector ~/.hermes/skills/writing/
cp -R skills/writing-prose ~/.hermes/skills/writing/
cp -R skills/writing-voice ~/.hermes/skills/writing/Or install an individual package with skills.sh:
npx skills add apoapostolov/humanizer --skill humanizer
npx skills add apoapostolov/humanizer --skill simple-english
npx skills add apoapostolov/humanizer --skill ai-writing-detector
npx skills add apoapostolov/humanizer --skill writing-prose
npx skills add apoapostolov/humanizer --skill writing-voiceskills/
├── humanizer/
├── simple-english/
├── ai-writing-detector/
├── writing-prose/
└── writing-voice/
Each package contains its own SKILL.md, agent metadata, references, and any runtime scripts it needs. Maintainer guidance is in AGENTS.md.
Support, feedback, and feature ideas: @ApoMakesMods on X.
This repository is licensed under the MIT License.
Simple English source limits and credits are documented in source-and-limits.md. Detector engine attribution is in ATTRIBUTION.md.