rlaope/oh-my-hermes / skills/omh-ai-slop-cleaner
omh-ai-slop-cleaner
Verified[omh] Messy or AI-generated code to clean up: delete AI-generated slop, dead code, and duplication while observable behavior stays identical. Use when the user says: ai-slop-cleaner, cleanup, deslop, refactor, risky, behavior-preserving refactor, refactor workflow, legacy refactor.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.2 KB |
| references/cleanup-passes.md | markdown | 6.6 KB |
| references/prose-lexicon.md | markdown | 4.3 KB |
| references/ui-review-checklist.md | markdown | 2.5 KB |
references/prose-lexicon.md
View on GitHub# Prose Lexicon
`ai-slop-cleaner` is deletion-first and written for code. Prose in a repository
needs the same pass and a different instrument: README text, docstrings, commit
bodies, review comments, and report prose carry machine-writing tells that no
code smell describes. Load this when the cleanup target is written English.
Three instruments, used together: a word list in tiers, a pattern catalog with
severity, and a context profile that decides which rules apply at all.
## Word tiers
The tier says how much a hit weighs, not how hard it is to fix. Match inflected
forms - a listed word covers its plural, gerund, adverb, and conjugations -
except where a variant carries an honest separate sense, which is judged in
context rather than matched.
- **Tier 1A, frequency markers.** Words that appear far more often in machine
text than in human writing. Replace every one. A cluster of them is evidence
about how the passage was produced. Typical members: delve, leverage as a
verb, seamless, robust as praise, testament, realm, landscape, pivotal,
underscore, harness as a verb.
- **Tier 1B, clarity edits.** Wordiness and inflated formality: in order to,
utilize, commence, ascertain, endeavor, prior to. Replace them too - the edit
is identical - but a 1B hit is **not** evidence of machine authorship. People
write this way. Keep 1B out of any density signal, so tightening wordy human
prose can never push a document toward an "AI-written" verdict.
- **Tier 2, cluster words.** Fine alone, suspicious together. Flag when two or
more appear in one paragraph.
- **Tier 3, density words.** Ordinary words that machine text overuses. Flag
only at high density across the document, never on a single occurrence.
Report 1A and 1B separately. Merging them is what turns a wordiness report into
a false authorship accusation.
## Pattern severity
Patterns are shapes, not words, and they carry three severities.
- **P0, credibility killers.** Training-cutoff disclaimers, assistant artifacts
left in the text, invented attributions to unnamed experts, unfilled
placeholders, chat citation markup, and tracking parameters pasted in with a
URL. Any one of these in a shipped document is a defect on its own.
- **P1, obvious tells.** Tier 1 vocabulary, slot-fill phrasing, "Let's" openers,
formulaic openings, bold on every other phrase, em dashes well above the rate
of ordinary prose, closing paragraphs that narrate a future, stacked hedges,
moral adjectives on things that cannot have morals, and bullet lists whose
items are bare noun phrases.
- **P2, polish.** Generic conclusions, the compulsive rule of three, uniform
paragraph lengths, copula avoidance, and transition words carrying no
transition.
## Context profiles
The same sentence is a defect in one register and correct in another. Name the
register before flagging anything.
| Profile | What it is | How the rules move |
| --- | --- | --- |
| `docs` | READMEs, guides, reference pages | clarity over voice; lists and structure are the format, not a smell |
| `code-comment` | comments, docstrings | strictest on overclaiming; a comment that asserts more than the code proves is P0 here |
| `commit-and-pr` | commit bodies, PR descriptions, review replies | strict on promotional and significance inflation; the reader is deciding whether to trust a claim |
| `report` | findings, postmortems, status writeups | extra strict on hedging and on anything that reads as evidence without being it |
| `casual` | internal notes, chat | P0 only |
When no profile is named, infer one from the destination and **say which one and
why** before reporting. The writer overrides. A rule absent from a profile's
adjustments applies at full strength.
## Running the pass
Prose cleanup follows the same discipline as `references/cleanup-passes.md`: one
category per pass, never bundled. Word tiers first, then patterns by severity,
then register fit. Between passes, re-read the paragraph whole - the failure
mode here is a document that passes every rule and no longer says anything,
because each fix was made against the rule instead of against the meaning.
Two edits are never in scope. Do not change a technical term because it appears
in a tier, and do not remove a hedge that is accurate; "may" in a sentence about
undefined behavior is doing work. Losing a true qualifier to a style rule turns
a correct document into a confident wrong one.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |