hallmark-check 🚫

Anti-AI-slop quality checker. Interactive checklist of 58 slop-test gates, 21 macrostructures, and 20 themes from Hallmark by Together AI.

npx @shift-zero/hallmark-check              # Generate interactive HTML report
npx @shift-zero/hallmark-check gates        # List all 58 gates in terminal
npx @shift-zero/hallmark-check macros       # List all 21 macrostructures
npx @shift-zero/hallmark-check themes       # List all 20 themes
npx @shift-zero/hallmark-check check <file> # Run basic automated checks on an HTML file

What is this?

Hallmark is a design skill for AI coding assistants that refuses to look AI-generated. It encodes 58 slop-test gates, 21 macrostructures (structural variety), 20 themes (visual variety), and a pre-emit self-critique system.

This companion tool makes Hallmark's knowledge portable and interactive:

• Interactive HTML report — Check off each gate as you verify it, with live pass/fail counts
• Terminal reference — Quick access to gates, macros, and themes
• Basic automated checks — Scan HTML files for common AI tells (default fonts, gradient text, re-drawn chrome, italic headers)

Install

npm install -g @shift-zero/hallmark-check

Or use directly:

npx @shift-zero/hallmark-check

Usage

Generate interactive report

hallmark-check
# Writes hallmark-report.html — open in browser

Click each gate checkbox as you verify it passes. The counter updates live.

Quick reference

hallmark-check gates          # All 58 gates grouped by category
hallmark-check macros         # All 21 macrostructures with descriptions
hallmark-check themes         # All 20 themes with descriptions

Automated check

hallmark-check check my-page.html
# Scans for AI-default fonts, gradient text, re-drawn chrome,
# transition:all, italic headers, and more

The 58 Slop-Test Gates

Every output must pass all 58 gates. Every answer must be no:

• Visual (1-7): Default fonts, gradients, 3-column cards, nested cards, centred hero, pure black/white
• Structural (8-9): Template reuse, uniform section rhythm
• Microinteractions (10-19): transition:all, uniform hover-scale, bouncy easings, multiple hovers, layout animation, focus rings, toasts
• Variety (20-21): Stamp presence, Specimen fall-through
• Implementation (22-27): Zero-chroma neutrals, accent footprint, arbitrary spacing, measure, state coverage, motion fallback
• Hero enrichment (28-31): Video autoplay, abstract backgrounds, icon tells, Lottie defaults
• Diversification (32-33): Variation knobs, accessible SVGs
• Layout safety (34-36): Horizontal scroll, text effects, flex alignment
• Typography (37-38a): 2+1 font rule, italic headers
• Input state (39): Border-width, focus ring, height, helper text, disabled
• Contrast (40-41): WCAG/APCA thresholds, button text, accent-ink
• Nav/Footer/Hero (42-45): Fingerprints, hero fit, decorative purpose
• Honesty (46): Invented metrics
• Chrome (47): Re-drawn UI chrome
• Tokens (48): Mid-render improvisation
• Responsive (49): Two-line clickable text
• Mobile (50-57): Grid tracks, display headers, section collapse, tab patterns, sticky bleed

The 21 Macrostructures

Never ship the same structure twice. Pick from Bento Grid, Long Document, Marquee Hero, Stat-Led, Workbench, Conversational FAQ, Manifesto, Photographic, Quote-Led, Specimen, Catalogue, Letter, Index-First, Narrative Workflow, Split Studio, Feature Stack, Type Specimen, Portfolio Grid, Map/Diagram, Ecosystem Index, Component Playground.

The 20 Themes

Editorial, Modern-Minimal, Atmospheric, Playful, Specimen, Midnight, Brutal, Garden, Atelier, Newsprint, Terminal, Manifesto, Almanac, Sport, Studio, Riso, Bloom, Coral, Cobalt, Aurora.

License

MIT. Based on Nutlope/hallmark (MIT) by Together AI.