Skip to content

v2.4.0 · antislop-human

Choose a tag to compare

View all tags
@miqdadbadjuber miqdadbadjuber released this 13 Aug 21:17
· 17 commits to main since this release
v2.4.0
b4f1246

antislop v2.4.0 ships the third skill in the antislop system: antislop-human, a filter for the human side of a UI, so the result works for people with different eyes, hands, and setups, not just someone with a mouse and perfect vision.

What's new

antislop-human (new skill)

Four sections, each with the pattern, why it matters, and the fix (tell → why → fix), citing the core rule:

  • Color & Contrast: low-contrast text, text over a photo or gradient, the grey-on-grey hallucination, non-text contrast, and The Contrast Checker
  • Keyboard: removed focus outline, mouse-only patterns, broken tab order
  • Focus & States: weak or invisible focus indicator, color-only feedback, missing UI states
  • Zoom & Mobile Use: text that cannot zoom (WCAG 1.4.4), mobile keyboard covering the form

The Contrast Checker (new)

The checker is antislop's answer to agents that claim WCAG AA without checking. Three layers, so it never blocks on any one of them:

  • scripts/contrast-check.py: run it for an exact ratio and a PASS/FAIL verdict for normal (4.5:1) and large (3:1) text
  • The WCAG 2.x formula: written out, for agents that cannot run code
  • A reference table: 8 common pairings with verified ratios

The skill makes the agent prove contrast, not assert it. #555 on black is 2.82:1 and fails; an agent that eyeballs it says it passes.

Mobile layout is its own skill

The human skill keeps the parts about people (zoom, keyboard covering the form). The layout mechanics behind mobile (breakpoints, grids, overflow, tap targets) move to a new skill, antislop-layoutmobile (v2.5.0), so the roadmap is now six skills.

Install wizard update

The wizard in antislop.md now offers four options (All / antislop-ui / antislop-copywriting / antislop-human) with a short "which concern do I need" description. Choosing human also downloads the contrast-check script into scripts/. Skill downloads are pinned to this release tag.

How to update

Existing users: add the new skill, the script, and one pointer line.

curl -o antislop-human.md https://raw.githubusercontent.com/miqdadbadjuber/anti-slop/v2.4.0/antislop-human.md
mkdir -p scripts
curl -o scripts/contrast-check.py https://raw.githubusercontent.com/miqdadbadjuber/anti-slop/v2.4.0/scripts/contrast-check.py

Then in your entry file's antislop block, add:

- People: antislop-human.md

New users: download antislop.md once, tell your agent to read it, and the wizard walks you through the rest.

Files in this release

- antislop.md (core + wizard)
- antislop-ui.md (skill, unchanged)
- antislop-copywriting.md (skill, unchanged)
- antislop-human.md (new skill)
- scripts/contrast-check.py (new script)

What's next

antislop-layoutmobile (v2.5.0), antislop-docs (v2.6.0), antislop-identity (v2.7.0), then v3.0.0: the whole system packaged as an installable skill/plugin. See ROADMAP.md.
Assets 2
Loading