prose-deslop

Remove AI writing patterns from technical prose, docs, ADRs, and PR bodies.

2|Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Thomo1318/gitCommitGenerator --skill prose-deslop-thomo1318
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prose-deslop
Source: https://github.com/Thomo1318/gitCommitGenerator/tree/main/.agents/skills/prose-deslop
Command: npx skills add https://github.com/Thomo1318/gitCommitGenerator --skill prose-deslop-thomo1318

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-generated prose carries predictable tells: filler phrases, formulaic structures, vague declaratives, and marketing puffery that make technical writing read as machine output. This Skill detects and rewrites those patterns in documentation, ADRs, PR bodies, and scientific writing while preserving technical accuracy and domain terminology. ## Core Features & Use Cases - Pattern catalogs: Five reference files catalog phrases, structures, tropes, and before/after examples covering throat-clearing openers, binary contrasts, dramatic fragmentation, false agency, and tech puffery. - Scoring rubric: Rates text 1-10 across directness, rhythm, trust, authenticity, and density; below 35/50 triggers revision. - Naming audit: Enforces domain-first naming for durable operator surfaces (recipes, paths, CLI commands) and distinguishes governance taxonomy citations from identity usage. - Git safety guards: Refuses to touch commit messages, run git commands, or mutate history unless the user explicitly opts in to desloping a draft commit message. - Use Case: Paste a draft ADR full of phrases like "seamlessly integrates" and "robust solution" and receive a rewritten version naming concrete databases, algorithms, and latency metrics, plus a naming audit table. ## Quick Start Ask the assistant to review this draft using the deslop checklist and rewrite it to pass the quick checks.

Frequently Asked Questions about prose-deslop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove AI writing patterns from technical documentation?

Paste the draft and ask for a deslop review. The skill checks against catalogs of filler phrases, formulaic structures, and AI tropes, then rewrites defective spans while preserving technical terms, quoted strings, and exact numbers.

What AI writing tells does deslop detect?

It flags throat-clearing openers, binary contrasts like "not X but Y", dramatic fragmentation, em-dash overuse, bold-first bullets, vague attributions, tech puffery like "blazing-fast", and synonym cycling across paragraphs.

Can deslop rewrite my git commit messages?

Not by default. The skill refuses to draft or rewrite commit messages and never runs git commands. Only explicit opt-in for a proposed draft message triggers the commit draft deslop flow, which still performs no git mutation.

Does deslop work for scientific writing and papers?

Yes. It accounts for scientific conventions like passive voice in methods sections and domain terminology, while still cutting filler, false agency, and vague declaratives. It uses "we" for your own work and requires named citations over vague attributions.

What is the deslop scoring rubric?

Text is rated 1-10 on five dimensions: directness, rhythm, trust, authenticity, and density. A total below 35 out of 50 means the text needs revision before delivery.

When should I not use prose deslop on a document?

Skip it when terms are literal, quoted, attributed, or technically domain-valid, such as cryptographic robustness claims or official framework names. The skill prefers a no-op over an uncertain edit and only changes the smallest defective span.