Skip to content

JasonColapietro/suede-creator-skills / skills/suede-deslop

suede-deslop

Verified

Use when asked "deslop this draft" or to audit finished prose before shipping. Suede Slop Stop Skills removes filler, false agency, formulaic rhythm, chat residue and misplaced formatting while preserving voice and protected facts. Returns edited prose and a 50-point score, or findings only. NOT FOR: rewriting the argument (use suede-copy), research orchestration (use suede-ship-copy), authorship detection, or certifying facts.

FileKindSize
CARD.mdmarkdown4.9 KB
SKILL.mdskill md13.0 KB
agents/openai.yamlconfig579 B
references/editing-rules.mdmarkdown10.3 KB
references/kill-list.mdmarkdown18.0 KB
references/usage-contract.mdmarkdown883 B

references/kill-list.md

View on GitHub
# Full Kill List

SKILL.md carries the 27 highest-frequency offenders. This file is the complete
sweep. Run it when the text goes to press, investors, or customers, or when the
SKILL.md table comes back clean and the text still reads generated.

Treat every entry as a contextual signal, not a token ban. Preserve wording
that carries technical meaning, quotation fidelity, deliberate voice, genre,
or the supplied house style. Apply the minimum edit that fixes the actual
problem in the supplied piece.

Sections marked *weak alone* describe choices a careful writer makes on purpose.
Act on one of those only when other tells share the passage. Every other section
justifies an edit on a single sighting.

## Suede house bans

For Suede public copy, these are hard bans, not contextual signals. They
apply to newly written prose; protected source spans, quotations, and a
supplied house style that says otherwise stay as they are.

| Ban | Replace with |
|---|---|
| Em dash (U+2014) in new prose | A period, comma, colon, or parentheses |
| moreover | Cut it, or "also" if the link is needed |
| delve, delve into | cover, examine, get into |
| game-changer | Name the change and its size |
| unlock, unleash | Say what was blocked and what now works |
| elevate | Say what changes, before and after |
| seamless, seamlessly | Name the step count or the handoff that disappeared |
| landscape (abstract) | The market, field, or named thing |
| tapestry | Cut the metaphor; name the parts |
| "it's important to note" | Cut it; state the point |
| Rule-of-three rhythm by default | Two items, or a full sentence, unless the count really is three |
| Heavy parallel structure (stacked "It means X. It means Y.") | One sentence with the strongest item and its proof |
| Promotional exclamation points | A period |

## Throat-clearing openers

Cut the opener; state the point. Any "here's what/this/that/why" construction
counts.

- "Here's the thing:"
- "Here's what [X]" / "Here's this [X]" / "Here's that [X]" / "Here's why [X]"
- "Here's what I find interesting"
- "Here's the problem though"
- "Let's be honest" / "Let's face it"
- "The truth is" / "The reality is"
- "The uncomfortable truth is"
- "It turns out"
- "The real [X] is"
- "Let me be clear" / "I want to be clear"
- "I'll say it again:"
- "I'm going to be honest"
- "Can we talk about"
- "It's worth noting that"
- "In today's fast-paced world" / "In today's [X]"
- "Picture this:" / "Imagine this:"
- "At its core" / "At the end of the day"
- "When it comes to"
- "In a world where"
- "Excited to announce" / "Thrilled to share" (empty launch setup; lead with the news)

## Emphasis crutches

Delete; they add no meaning.

- "Let that sink in" / "Read that again"
- "Full stop." / "Period." (as emphasis)
- "Make no mistake"
- "This matters because"
- "Here's why that matters"

## Business jargon

| Kill | Fix |
|------|-----|
| leverage (as a verb) | use |
| utilize | use |
| delve into | cover, get into |
| unpack | explain, examine |
| navigate (a challenge) | handle, work through |
| lean into | accept, embrace |
| landscape / ecosystem (abstract) | market, field, or the named thing |
| journey (not travel) | process, or name the steps |
| game-changer | name the change |
| double down | commit, increase |
| deep dive | analysis, examination |
| take a step back | reconsider |
| moving forward | next, from now |
| circle back | return to, revisit |
| on the same page | aligned, agreed |
| unlock / unleash | say what was blocked |
| robust / seamless / powerful | name the capability or prove it |
| elevate / empower / transform | say what changes, before and after |
| innovative / revolutionary / next-generation | name the actual change, or cut empty praise |
| game-changing / cutting-edge | name the change or capability |
| solution | name the product or action |
| streamline | name the removed step or supported time reduction |
| intuitive / simple / easy | use a supplied interaction detail or step count |
| best-in-class / world-class | use a supplied benchmark or credential, or cut empty praise |
| end-to-end / holistic | name the actual start, end, or scope |
| scalable | name the supported load and conditions |
| synergy / synergistic / value-add | name the cooperation or concrete value |
| best practices | name the practice |
| in order to | to |
| due to the fact that | because |
| at this point in time | now |
| going forward | state the new behavior |

Keep "we believe" or "we think" when it marks an opinion or necessary uncertainty.
Cut it only when it is empty throat-clearing, not a factual qualifier. Proof-based
replacements use supplied evidence only; never borrow a sample metric or product
claim to make a sentence sound specific. Preserve unsupported factual wording and
report the evidence gap separately during a style-only pass.

## Adverbs that add no information

Cut an adverb when it merely intensifies, softens, or announces importance.
Keep it when it carries factual, technical, legal, quoted, or voice-specific
meaning. Common low-information candidates:

really, just, very, literally, genuinely, honestly, simply, actually, deeply,
truly, fundamentally, essentially, ultimately, inherently, inevitably,
interestingly, importantly, notably, crucially, incredibly, remarkably,
surprisingly, seamlessly, effortlessly.

## Meta-commentary

The piece moves; it never announces its own structure.

- "Hint:"
- "Plot twist:" / "Spoiler:"
- "You already know this, but"
- "But that's another post"
- "X is a feature, not a bug"
- "Dressed up as"
- "The rest of this essay/piece explains..."
- "Let me walk you through..."
- "In this section, we'll..."
- "As we'll see..."
- "I want to explore..."

## Performative emphasis

False intimacy and manufactured sincerity.

- "creeps in"
- "I promise"
- "They exist, I promise"

## Telling instead of showing

Announcing difficulty or significance instead of demonstrating it.

- "This is genuinely hard"
- "This is what leadership actually looks like"
- "This is what X actually looks like"
- "actually matters"

## Vague declaratives

The sentence announces weight without naming the thing. Cut it or replace it
with the specific thing.

- "The reasons are structural"
- "The implications are significant"
- "This is the deepest problem"
- "The stakes are high"
- "The consequences are real"

## Binary contrasts: all variants

Telegraphed reversals. Fix: state Y directly and drop the negation.

- "Not because X. Because Y." / "Not because X, but because Y."
- "[X] isn't the problem. [Y] is."
- "The answer isn't X. It's Y."
- "It feels like X. It's actually Y."
- "The question isn't X. It's Y."
- "Not X. But Y." / "not X, it's Y" / "isn't X, it's Y"
- "It's not this. It's that." / "It's not about X. It's about Y."
- "This isn't just X, it's Y" / "not just X but also Y"
- "stops being X and starts being Y"
- "doesn't mean X, but actually Y"
- "is about X but not Y"

## Negative listing

A rhetorical striptease. Fix: state Z; the reader does not need the runway.

- "No setup. No config. No hassle." (marketing stack)
- "Not a X... Not a Y... A Z." (buildup through negation)
- "It wasn't X. It wasn't Y. It was Z." (same, past tense)

## Dramatic fragmentation

Manufactured profundity. Fix: complete sentences; attach fragments to the
sentence they modify.

- "One problem." / "And it worked."
- "[Noun]. That's it. That's the [thing]."
- "X. And Y. And Z."
- "This unlocks something. [Word]."

## Rhetorical setups

Announce insight instead of delivering it. Fix: delete the question or
preview; give the answer.

- "So what does this mean for you?"
- "What if [reframe]?" / "What if I told you...?"
- "Here's what I mean:"
- "Think about it:"
- "And that's okay." (unnecessary permission)

## Formulaic constructions

- "By the time X, I was Y." (narrative template; state the fact)
- "X that isn't Y" (indirect; say "X is broken")
- False transformation arcs (a routine change narrated as a revolution; state the actual change)

## False agency

Inanimate things doing human verbs. Fix: name the human. If no specific person
fits, use "you" to put the reader in the seat.

- "the data tells us" (someone read it and concluded)
- "the essay argues" (the author argues)
- "a complaint becomes a fix" (someone fixed it)
- "a bet lives or dies in days" (someone ships it or kills it)
- "the decision emerges" (someone decides)
- "the culture shifts" (people change behavior)
- "the conversation moves toward" (someone steers)
- "the market rewards" (buyers pay for things)

## Narrator-from-a-distance

Floating above the scene. Fix: put the reader in the room.

- "Nobody designed this."
- "This happens because..."
- "This is why..."
- "People tend to..."

## Passive voice

Fix: find the actor, put them at the front of the sentence.

- "X was created" (name who created it)
- "It is believed that" (name who believes it)
- "Mistakes were made" (name who made them)
- "The decision was reached" (name who decided)

## Sentence starters

- Sentences opening with What / When / Where / Which / Who / Why / How:
  restructure. "What makes this hard is..." becomes "The constraint is...", or
  name the specific constraint.
- Paragraphs opening with "So": start with content.
- Sentences opening with "Look,": remove.

## Rhythm patterns

- Three-item lists: use two items or one, unless the count is really three.
- Questions answered in the same breath: let the question breathe or cut it.
- Every paragraph ending punchy: vary endings.
- Em dashes: follow the supplied house style. Suede public copy uses commas, parentheses, colons, or periods instead.
- Staccato fragments stacked for effect: merge them.
- "Not always. Not perfectly.": hedging dressed as reassurance. Cut it.

## Lazy extremes

every, always, never, everyone, everybody, nobody. False authority doing vague
work. Replace the sweeping claim with the specific.

---

The sections below cover chat residue, borrowed authority, and formatting applied
by rule. They matter most in READMEs, documentation, agent instruction files, and
reference prose, where they do more damage than any phrase above.

## Chat and draft leftovers

A wrapper meant for one conversation, left in text that has to stand on its own.
The most certain signal in this file, and the easiest to miss when it surrounds
real content. Delete the wrapper; keep what is inside it.

- "Great question!" / "Of course!" / "Certainly!" / "Absolutely!"
- "You're absolutely right" / "Good catch"
- "I hope this helps" / "Hope that clarifies"
- "Let me know if you'd like me to expand" / "let me know if you need anything else"
- "Would you like...?" / "Want me to...?" / "Should I continue?"
- "Here is a..." / "Below is a..." opening a document that is the thing itself

## Knowledge-limit disclaimers and guesses

The text names where the model's knowledge stopped, or admits it found nothing
and then fills the hole with something plausible. State what the source does not
show, or cut the sentence. Never present a guess as a fact.

- "as of my last training update" / "as of [date]" (when the date is the cutoff, not a fact about the subject)
- "while specific details are limited" / "based on available information"
- "in the provided sources" / "not widely documented" / "not publicly available"
- "maintains a low profile" / "keeps personal details private" (inferred from absence)
- "likely grew up" / "likely studied" / "it is believed that" (a guess dressed as a finding)

## Arguing with no one

The text answers an objection or rejects an option that appears nowhere else,
usually a leftover from an earlier draft. Cut the defense; if it carries a real
claim, state the claim. Keep an objection the text attributes and answers in
full, and keep an option a reader would genuinely weigh.

- "I'm not saying" / "This is not to say" / "Don't get me wrong"
- "To be clear," (as a standalone opener)
- "Some might say... but"
- "A tempting approach would be" / "One might be tempted to" / "An obvious approach would be"
- "You might think... but" / "It would be easy to just"

Several unrelated rejections in a row are a stronger signal than one.

## Borrowed authority

An unnamed authority props up a claim, or a list of prestigious outlets props up
a person. Use the real source and what it said when the text supplies one.
Otherwise cut the claim or the list. Never invent a source. A missing citation by
itself is not a signal; most writing is unsourced.

- "experts argue" / "experts believe" / "researchers say" (unnamed)
- "observers have cited" / "some critics" / "industry reports suggest"
- "cited in [list of outlets]" / "featured in" / "profiled by" as a credential
- "independent coverage" / "trade publications"
- "active social media presence" / "over N followers" as evidence of standing

## Vague connection

Two things are said to be related without saying how, which hides whether the
person was the CEO, a board member, or a consultant. Name the relationship the
source gives. If the source does not say, keep the vague wording rather than
inventing a role.

- "associated with" / "in association with"
- "connected to" / "in connection with"
- "linked to" / "tied to"
- "involved with" / "part of" (when the role is knowable and omitted)

## Avoiding is, are, and has

A simple verb replaced with a longer phrase. Use is, are, has.

| Kill | Fix |
|------|-----|
| serves as | is |
| stands as | is |
| functions as / operates as | is, works as |
| represents a / marks a | is |
| boasts | has |
| features / offers / maintains (a) | has |
| refers to | is, means |

## Overused AI words

Models reach for these far more often than people do, and they cluster. One
formal word is not a signal; four in a paragraph is. Keep every technical sense.

Actually, additionally, align with, bolstered, crucial, deep dive, delve,
emphasizing, enduring, enhance, fostering, garner, gated (figurative),
highlight (verb), interplay, intricate, key (adjective), landscape (abstract),
meticulous, pivotal, quietly, robust (figurative), showcase, tapestry,
testament, underscore (verb), valuable, vibrant.

## Inflated significance

An ordinary detail is said to mark a turning point, prove a legacy, or promise a
future. It appears at three scales: a phrase, a stock section, and a send-off
paragraph. Keep the fact; drop the significance. End on the last concrete fact.
If the source states real plans, use those.

- "stands as a testament to" / "underscores its importance"
- "a pivotal moment" / "a crucial turning point" / "plays a key role"
- "marking the" / "shaping the" / "setting the stage for"
- "reflects a broader" / "an enduring legacy" / "left an indelible mark"
- "the evolving landscape of"
- "Despite these challenges, X continues to thrive"
- Stock sections titled "Challenges and Legacy", "Future Outlook", "Awards and recognition"
- "the future looks bright" / "exciting times ahead" / "a step in the right direction"

## Shallow -ing riders

An -ing phrase bolted onto a plain fact to make it sound deeper. Attaching it to
a named source does not make it true. Keep the fact; keep the rider only when the
source supports what it claims.

highlighting, underscoring, emphasizing, ensuring, reflecting, symbolizing,
contributing to, cultivating, fostering, encompassing, showcasing,
demonstrating, illustrating (when no demonstration is given).

## Sales language

The text reads like an advertisement, most often for a place, a product, a
culture, or an organization. State what the thing is.

boasts, vibrant, rich (figurative), profound, enhancing, exemplifies,
commitment to, natural beauty, nestled, in the heart of, groundbreaking
(figurative), renowned, featuring, diverse array, breathtaking, must-visit,
stunning, seamlessly integrated, unparalleled.

## Sayings that sound deep

An ordinary point dressed as a hidden truth, with no detail added by the dress.
Replace the saying with the specific claim.

- "the real question is" / "what really matters"
- "at its core" / "fundamentally" / "in reality"
- "the deeper issue" / "the heart of the matter"
- "X is the Y of Z" ("symmetry is the language of trust")
- "X becomes a trap" / "X is not a tool but a mirror"
- "the language of" / "the currency of" / "the architecture of" (abstract)

## Formatting by rule

Decoration on every item is the signal, not decoration anywhere. Templates and
visual editors produce clean formatting too, so judge across the document.

- Bold on terms carrying no more weight than their neighbors: remove the bold.
- Every bullet opening `**Label:**` and then restating the label: turn the list into prose.
- Title Case Headings: use sentence case.
- An emoji or an arrow on each heading or bullet: strip the ornament.
- A horizontal rule between every section: remove the rules.
- The document title repeated as a heading under itself: let it stand once.
- A heading restated in the one-line paragraph below it: delete the restatement.
- Documentation describing the version it replaced: describe current behavior. Prior-version talk belongs in changelogs, release notes, and migration guides.

## Weak alone

Each of these is a normal writing choice on its own. Act only when other tells
share the passage, or when the supplied house style settles it.

- **Hyphenated pairs everywhere** (third-party, cross-functional, client-facing, data-driven, decision-making, well-known, high-quality, real-time, long-term, end-to-end). Keep the hyphen before a noun where grammar needs it (`a high-quality report`); drop it after (`the report is high quality`).
- **Repeated sentence openings.** Three sentences in a row starting with the same subject. Merge them, change the subject, or lead with the action. Do not ban the word; writers also repeat an opening on purpose.
- **Stacked qualifiers** (to be fair, it's also possible, could potentially, might arguably, in some cases it may). Keep a qualifier the source supports and the meaning needs. Keep scope statements, legal and safety notices, and real corrections. Ordinary hedges such as *perhaps* or *tends to* are human habits.
- **Curly quotation marks** where the writer or target format uses straight quotes. Most editors auto-curl.
- **A single em dash** in text outside Suede house style. Many editors and journalists use them. A text full of them is a different matter; follow the supplied house style. Suede public copy bans them outright (see Suede house bans).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall