Skip to content
Back to search

gesso

MarketplaceWorks with Claude CodeGitHub

Deterministic design critique for HTML/CSS: 73 slop guards from the rules professional designers use in production-grade designs. Exact detectors, idempotent auto-fixes, the anti-slop skill, and the /gesso-critique command. By Gesso, the AI creative team for builders.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gesso-build--skills/badge.svg)](/listings/gesso-build--skills)

HTML

<a href="/listings/gesso-build--skills"><img src="/api/listings/gesso-build--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx -y @gessobuild/anti-slop install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "gesso",
  3. "owner": {
  4. "name": "Gesso",
  5. "url": "https://gesso.build"
  6. },
  7. "metadata": {
  8. "description": "Gesso's anti-slop toolkit: deterministic slop guards, /gesso:critique, and the anti-slop skill."
  9. },
  10. "plugins": [
  11. {
  12. "name": "gesso",
  13. "source": "./",
  14. "description": "73 deterministic slop guards + /gesso:critique second-opinion reviews for HTML/CSS."
  15. }
  16. ]
  17. }
README.md · README · 251 lines
  1. # @gessobuild/anti-slop
  2. [![npm](https://img.shields.io/npm/v/@gessobuild/anti-slop)](https://www.npmjs.com/package/@gessobuild/anti-slop)
  3. [![license](https://img.shields.io/npm/l/@gessobuild/anti-slop)](LICENSE)
  4. [![docs](https://img.shields.io/badge/docs-grey)](skills/anti-slop/references/rules.md)
  5. A deterministic design critique for HTML/CSS, extracted from the set of
  6. rules professional designers use in production-grade designs.
  7. "Slop" is the set of visual tells that make generated UI read as generated:
  8. the gradient-clipped headline, the indigo accent nobody chose, the puffy
  9. stacked drop-shadow, the emoji standing in for an icon system, the row of
  10. equal dots faking a chart, the badge card floated over the hero, the em
  11. dash mid-sentence, the `$1,842,000` figure no designer would typeset raw.
  12. This package holds 73 of those tells as executable rules: each one a
  13. documented detector with an exact threshold, most with a deterministic,
  14. idempotent, design-preserving auto-fix. Simple tells are regex-level;
  15. structural tells are found by parsing the markup (never executing it).
  16. The detector reads `.html` files (inline styles and `<style>` blocks):
  17. exports, prototypes, static builds, generated screens. It does not parse
  18. JSX/TSX source; render or export to HTML first, then check the output.
  19. # Install
  20. ```bash
  21. npx -y @gessobuild/anti-slop install
  22. ```
  23. # Use
  24. ```
  25. /gesso-critique page.html
  26. ```
  27. That one command is the whole loop: the deterministic verdict with
  28. evidence, the auto-fixes on request, then a clearly-labeled second
  29. opinion. You can also just ask ("check this for slop", "second opinion
  30. on this screen"), and the installed skill runs the check on its own
  31. before the agent shows, ships, or commits HTML/CSS.
  32. The install copies the skill and the command into the current project's
  33. `.claude/`, git-reviewable (`--global` targets `~/.claude/` instead).
  34. Everything you install is committed here word for word:
  35. [SKILL.md](skills/anti-slop/SKILL.md),
  36. [rules.md](skills/anti-slop/references/rules.md),
  37. [critique.md](commands/critique.md).
  38. ## Other ways to install
  39. On another agent (Codex, Cursor, Amp, and friends), install through the
  40. [skills CLI](https://www.skills.sh/gesso-build/skills/anti-slop); there
  41. is no slash command there, so trigger it by asking for a slop check or
  42. critique:
  43. ```bash
  44. npx skills add Gesso-Build/skills
  45. ```
  46. Claude Code users can install the plugin instead. Note the plugin spells
  47. the command `/gesso:critique` (colon, not hyphen):
  48. ```
  49. /plugin marketplace add Gesso-Build/skills
  50. /plugin install gesso@gesso
  51. ```
  52. ## CLI
  53. Nothing to install for one-off checks and CI:
  54. ```bash
  55. npx -y @gessobuild/anti-slop check page.html # verdict + tells; exit 1 on slop
  56. npx -y @gessobuild/anti-slop check dist/ --json # machine-readable, whole tree
  57. npx -y @gessobuild/anti-slop fix page.html --write # apply the deterministic fixes
  58. ```
  59. On editorial/marketing pages, add `--marketing` to `check` or `fix`:
  60. `em-dash-copy` then reports as advisory instead of gating, and the fixer
  61. leaves authored em dashes alone. In interface chrome the tell stays
  62. gating.
  63. `check` exits 0 on clean, 1 on slop, 2 on usage errors, so a CI step is one
  64. line (see [Wiring it into CI](skills/anti-slop/SKILL.md#wiring-it-into-ci)).
  65. Advisory (FLAG-tier) hits are reported for context but never affect the
  66. verdict or the exit code. `fix` is idempotent: running it twice is a no-op.
  67. A failing check prints `SLOP (severity N, M advisory)`: severity is a
  68. weighted sum of distinct gating tells, capped at 4 per rule so one runaway
  69. pattern cannot drown the rest, and the advisory count is the genre-dependent
  70. context that never gates. Read severity 1-2 as an isolated tell, 3-6 as a
  71. pattern with a shared cause, and 7+ as template-grade slop that needs design
  72. attention beyond the fixes; those bands are calibrated for a single screen,
  73. so compare longer documents on severity plus the advisory count together,
  74. never severity alone. A `pass` is stricter than a low score: it means zero
  75. FIX/GATE hits. When a document links external stylesheets it does not
  76. inline, the check says so and every style-dependent result is a lower
  77. bound.
  78. ## The 73 guards
  79. FIX rules are auto-fixable; GATE rules are detect-only because the right
  80. fix needs a decision the tool refuses to fake (which properties to animate,
  81. what the copy should say, which real image to use); FLAG rules are advisory
  82. and never affect the verdict, because their tell is genre-dependent (an
  83. over-designed list row is a defect on an app feed but the genre on a
  84. marketing page); BASE rules are additive polish whose absence is not a
  85. defect (they never affect the verdict; `fix` injects the default once,
  86. idempotently). Every guard's exact detection condition, rationale, and
  87. before/after pair is documented in
  88. [skills/anti-slop/references/rules.md](skills/anti-slop/references/rules.md).
  89. | Guard | Category | Tier | Catches |
  90. | --- | --- | --- | --- |
  91. | `gradient-text` | color | FIX | gradient clipped into headline text |
  92. | `indigo-accent` | color | FIX | the default Tailwind indigo/violet accent |
  93. | `gradient-fill` | color | FIX | a gradient fill on a rounded tile/card/chip/button |
  94. | `multicolor-fill` | color | FIX | multi-hue entity fills (pink-to-purple tiles) |
  95. | `multicolor-heading` | color | FIX | two-tone headlines (accent-dipped words) |
  96. | `purple-violet-wash` | color | FIX | the wider saturated violet band behind the indigo list |
  97. | `safe-green-default` | color | FLAG | Tailwind emerald as the escape-hatch accent |
  98. | `cream-default-wash` | color | FLAG | the cream ground + serif display costume |
  99. | `hollow-text` | type | FIX | outlined letterforms via text-stroke + transparent fill |
  100. | `underlined-text` | type | FIX | underlines on UI text and links |
  101. | `all-caps-body` | type | FIX | uppercase body passages over 60 characters |
  102. | `emoji-icon` | type | FIX | a leading emoji used as an icon glyph |
  103. | `mixed-style-headline` | type | FIX | headlines swerving from upright into italic |
  104. | `overused-font-stack` | type | FLAG | Inter / Space Grotesk / Geist / Instrument Serif defaults |
  105. | `single-font-page` | type | FLAG | one family carrying the whole page |
  106. | `crushed-tracking` | type | FIX | display tracking at -0.05em or tighter |
  107. | `wide-body-tracking` | type | FIX | 0.08em+ tracking on mixed-case text |
  108. | `tight-line-height` | type | FIX | body-size text with line-height under 1.25 |
  109. | `tiny-body-text` | type | FIX | mixed-case text under 11px |
  110. | `monospace-body` | type | FLAG | prose set in a code font |
  111. | `text-wrap-orphans` | type | BASE | headings/copy without balance/pretty wrapping |
  112. | `font-smoothing` | type | BASE | no root antialiasing (over-heavy macOS type) |
  113. | `heavy-box-shadow` | visual | FIX | stacked or high-alpha "puffy card" shadows |
  114. | `gradient-border` | visual | FIX | gradient rings around avatars/cards |
  115. | `bare-hr` | visual | FIX | full-opacity 3D `<hr>` dividers |
  116. | `decorative-divider` | visual | FIX | box-drawing or dash runs used as chrome |
  117. | `repeating-gradient-stripe` | visual | FIX | repeating-gradient stripes as surface decoration |
  118. | `fake-dot-viz` | visual | FIX | equal dot/node clusters faking a chart |
  119. | `viz-stray-ticks` | visual | FIX | decorative radiating ticks on a gauge/arc |
  120. | `glyph-on-metric` | visual | FIX | an emoji/icon stacked on a numeric value |
  121. | `stat-label-icon` | visual | FIX | a redundant leading icon on a stat's category label |
  122. | `edge-stripe` | visual | FIX | thick colored border-left/right rails on cards and rows |
  123. | `redundant-border` | visual | FIX | opaque borders boxing already-filled elements |
  124. | `dark-glow` | visual | FIX | saturated wide-blur glow shadows (the neon dark-SaaS look) |
  125. | `over-rounded-card` | visual | FIX | 40px+ radii turning filled cards into blobs |
  126. | `ghost-card` | visual | FIX | hairline border + wide soft halo on one surface |
  127. | `floating-hero-card` | layout | FIX | decorative badge cards floated over the hero |
  128. | `grid-spacer-void` | layout | FIX | hairline dividers stranded in tall fixed grid rows |
  129. | `wrap-padding-collision` | layout | FIX | `padding: V 0` clobbering the container's inset |
  130. | `body-display-contents` | layout | FIX | `display:contents` on `<body>` collapsing the page |
  131. | `hscroll-snap-gutter` | layout | BASE | snap carousels missing scroll-padding for their gutter |
  132. | `hero-kicker-eyebrow` | layout | FIX | the uppercase kicker badge above the H1 |
  133. | `reveal-specificity-trap` | layout | FIX | scroll-reveal CSS whose hidden state wins forever |
  134. | `row-kicker-eyebrow` | layout | FLAG | ALL-CAPS kickers stacked above every list row's title |
  135. | `multiline-row-meta` | layout | FLAG | quotes/descriptions wrapping to 2+ lines inside list rows |
  136. | `overstuffed-row` | layout | FLAG | repeated rows carrying more than 3 info slots |
  137. | `row-as-card` | layout | FLAG | uniform text rows each boxed as its own elevated card |
  138. | `nested-cards` | layout | GATE | surfaced card containers nested inside cards |
  139. | `numbered-section-markers` | layout | FLAG | decorative 01 / 02 / 03 section scaffolding |
  140. | `icon-topped-feature-card` | layout | FLAG | the icon-heading-blurb card template, x3 |
  141. | `transition-all` | motion | GATE | `transition: all` instead of named properties |
  142. | `will-change-misuse` | motion | FIX | will-change on layout/paint props or `all` |
  143. | `bounce-easing` | motion | FIX | overshoot cubic-bezier springs on UI motion |
  144. | `layout-prop-animation` | motion | GATE | transitions on width/height/top/left/margin/padding |
  145. | `hover-scale-image` | motion | FLAG | the reflex scale() zoom on image hover |
  146. | `cents-suffix` | copy | FIX | fake `.20` price-decimal suffix spans |
  147. | `oversized-number` | copy | FIX | un-abbreviated figures of 10,000+ |
  148. | `em-dash-copy` | copy | FIX | em dashes (U+2014) in interface copy |
  149. | `lorem-ipsum` | copy | GATE | lorem-ipsum filler in a finished screen |
  150. | `viz-redundant-scale` | copy | FIX | 0/N gauge endpoint labels restating a 7/10 value |
  151. | `live-clock-eyebrow` | copy | FIX | "LIVE 09:41" dot badges and wall-clock eyebrows |
  152. | `publication-masthead-block` | copy | FIX | invented VOLUME/CATALOGUE/serial metadata clusters |
  153. | `masthead-eyebrow` | copy | FIX | lone VOL./ISSUE/№ magazine eyebrows |
  154. | `benefit-speak` | copy | GATE | Elevate / Supercharge / Seamlessly marketing filler |
  155. | `not-x-but-y-cadence` | copy | FLAG | the "it's not just X, it's Y" rebuttal rhythm |
  156. | `fabricated-precision` | copy | FLAG | 99.9% / 10x / #1 / "trusted by thousands" filler stats |
  157. | `apologetic-error-copy` | copy | GATE | "Oops! Something went wrong" error copy |
  158. | `broken-image` | imagery | FIX | empty, missing, or template-placeholder `src` |
  159. | `missing-alt` | imagery | FIX | `<img>` without an alt attribute |
  160. | `placeholder-image` | imagery | GATE | placeholder-service URLs (pravatar, picsum...) |
  161. | `image-outline` | imagery | BASE | content images with no inset edge hairline |
  162. | `justified-text` | quality | FIX | rivers-of-white justified copy |
  163. | `missing-lang` | quality | FIX | `<html>` without a `lang` attribute |
  164. ### Opting out intentionally
  165. A deliberately "slop-shaped" element opts out per rule, visibly in the
  166. markup, so the decision is reviewable:
  167. - element rules: `data-slop-allow="rule-id"` attribute (list or `"all"`),
  168. - CSS rules: a `--slop-allow: rule-id` custom property in the same
  169. declaration block.
  170. ## Library
  171. ```ts
  172. import {
  173. runSlopGuard,
  174. applySlopFixes,
  175. buildSlopConstraintsBlock,
  176. FLAGSHIP_RULES,
  177. } from "@gessobuild/anti-slop"
  178. const check = runSlopGuard(html, {}, FLAGSHIP_RULES)
  179. // { pass, issues, severity, counts }
  180. const fixed = applySlopFixes(html, {}, FLAGSHIP_RULES)
  181. // { html, fixes, total } -- idempotent
  182. const promptBlock = buildSlopConstraintsBlock(undefined, FLAGSHIP_RULES)
  183. // negative constraints to paste into your generation system prompt
  184. ```
  185. Each rule is one source of truth for three artifacts: a **prevention**
  186. constraint you inject into a generation prompt, a **detect** pass over the
  187. HTML string, and (for FIX-tier rules) a deterministic **fix**. The engine is
  188. generic over the rule context: register your own rules with richer
  189. style/token types alongside (or instead of) the flagship registry. Every
  190. detect/fix call is wrapped in try/catch, so a buggy rule degrades to "no
  191. hit / no fix" and never breaks a pipeline. Faithful-replication workflows
  192. can pass `{ replicate: true }` to sanction expressive treatments (gradient
  193. headlines) the reference legitimately uses.
  194. ## Security
  195. The detector parses markup as text. It never executes, renders, or
  196. fetches anything: no network access, no child processes, no install
  197. hooks, and a single runtime dependency (`node-html-parser`). Evidence
  198. excerpts quoted into a report are length-bounded, and the skill treats
  199. them strictly as data to report, never as instructions to follow. As
  200. with any tool that quotes untrusted file content to an agent, a bounded
  201. injection surface is inherent to the category; the automated audit
  202. results on the [skills.sh
  203. listing](https://skills.sh/gesso-build/skills/anti-slop) carry the
  204. detail.
  205. ## Made by Gesso
  206. This package is maintained by [Gesso](https://gesso.build), the AI
  207. creative team for builders: explore the sea of creative ideas and build
  208. with Gesso. Designs created at [app.gesso.build](https://app.gesso.build)
  209. arrive with this check already applied; run it on everything else you
  210. ship.
  211. ## License
  212. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.