Skip to content

nexu-io/open-design / plugins/community/hallmark

hallmark

Flagged

Anti-AI-slop design skill for greenfield pages, audits, redesigns, and design extraction from URLs or screenshots. Use when the user asks to build a new app or landing page, wants to redesign something, invokes Hallmark by name, or uses audit/redesign/study.

FileKindSize
LICENSEother1.1 KB
SKILL.mdskill md61.5 KB
open-design.jsonconfig1.4 KB
references/anti-patterns.mdmarkdown24.6 KB
references/assets.mdmarkdown24.7 KB
references/color.mdmarkdown4.2 KB
references/component-cookbook.mdmarkdown27.9 KB
references/components/c1-outlined-chip.mdmarkdown464 B
references/components/c2-inline-form-as-cta.mdmarkdown672 B
references/components/c3-typographic-link.mdmarkdown280 B
references/components/c4-sticky-bottom-bar.mdmarkdown671 B
references/components/f1-bento-grid.mdmarkdown782 B
references/components/f2-sticky-scroll-stack.mdmarkdown899 B
references/components/f3-tabular-spec-sheet.mdmarkdown419 B
references/components/f4-step-sequence.mdmarkdown448 B
references/components/f5-annotated-screenshot.mdmarkdown410 B
references/components/f6-product-card-grid.mdmarkdown2.7 KB
references/components/ft1-mast-headed.mdmarkdown501 B
references/components/ft2-inline-rule-single-line.mdmarkdown362 B
references/components/ft3-index-style-category-list.mdmarkdown483 B
references/components/ft4-dense-typographic.mdmarkdown501 B
references/components/ft5-statement.mdmarkdown1.3 KB
references/components/ft6-letter-close.mdmarkdown1.1 KB
references/components/ft7-newsletter-first.mdmarkdown1.7 KB
references/components/ft8-marquee-scroll.mdmarkdown1.5 KB
references/components/h1-marquee.mdmarkdown507 B
references/components/h2-split-diptych.mdmarkdown600 B
references/components/h3-quote-led.mdmarkdown420 B
references/components/h4-stat-led.mdmarkdown509 B
references/components/h5-letter-hero.mdmarkdown361 B
references/components/h6-photographic-fold.mdmarkdown586 B
references/components/h7-demo-video-clipped-by-viewport-edge.mdmarkdown1.6 KB
references/components/h8-mockup-split-browser-framed.mdmarkdown1.3 KB
references/components/h9-custom-illustration-centerpiece.mdmarkdown1.4 KB
references/components/n1-wordmark-2-links.mdmarkdown388 B
references/components/n10-floating-on-scroll-morph.mdmarkdown1.4 KB
references/components/n2-floating-chip.mdmarkdown617 B
references/components/n3-side-rail.mdmarkdown536 B
references/components/n4-hidden-behind-k.mdmarkdown373 B
references/components/n5-floating-pill.mdmarkdown1.4 KB
references/components/n6-newspaper-masthead.mdmarkdown1.6 KB
references/components/n7-brutal-slab.mdmarkdown1.3 KB
references/components/n8-terminal-command.mdmarkdown1.6 KB
references/components/n9-edge-aligned-minimal.mdmarkdown867 B
references/components/s1-left-margin-numbered.mdmarkdown495 B
references/components/s2-hanging.mdmarkdown357 B
references/components/s3-sticky-pinned.mdmarkdown1.2 KB
references/components/s4-inline-no-break.mdmarkdown438 B
references/components/s5-bottom-anchored.mdmarkdown358 B
references/components/t1-pull-quote-with-marginalia.mdmarkdown465 B
references/components/t2-logo-wall-hairline.mdmarkdown733 B
references/components/t3-single-huge-quote.mdmarkdown490 B
references/components/t4-numbered-stat-strip.mdmarkdown470 B
references/contract.mdmarkdown1.3 KB
references/copy.mdmarkdown12.0 KB
references/custom-craft.mdmarkdown33.3 KB
references/custom-theme.mdmarkdown19.6 KB
references/design-md.mdmarkdown6.7 KB
references/export-formats.mdmarkdown13.3 KB
references/floating-nav.mdmarkdown5.1 KB
references/genres/atmospheric.mdmarkdown3.9 KB
references/genres/editorial.mdmarkdown3.7 KB
references/genres/modern-minimal.mdmarkdown3.9 KB
references/genres/playful.mdmarkdown3.8 KB
references/hero-enrichment.mdmarkdown30.7 KB
references/imagery-kit.mdmarkdown8.3 KB
references/interaction-and-states.mdmarkdown12.7 KB
references/layout-and-space.mdmarkdown6.0 KB
references/macrostructures.mdmarkdown11.3 KB
references/macrostructures/01-bento-grid.mdmarkdown1.8 KB
references/macrostructures/02-long-document.mdmarkdown1.7 KB
references/macrostructures/03-marquee-hero.mdmarkdown1.6 KB
references/macrostructures/04-stat-led.mdmarkdown1.6 KB
references/macrostructures/05-workbench.mdmarkdown1.7 KB
references/macrostructures/06-conversational-faq.mdmarkdown1.6 KB
references/macrostructures/07-manifesto.mdmarkdown1.7 KB
references/macrostructures/08-photographic.mdmarkdown1.5 KB
references/macrostructures/09-quote-led.mdmarkdown1.8 KB
references/macrostructures/10-specimen.mdmarkdown1.6 KB
references/macrostructures/11-catalogue.mdmarkdown1.2 KB
references/macrostructures/12-letter.mdmarkdown1.2 KB
references/macrostructures/13-index-first.mdmarkdown1.2 KB
references/macrostructures/14-narrative-workflow.mdmarkdown1.4 KB
references/macrostructures/15-split-studio.mdmarkdown1.3 KB
references/macrostructures/16-feature-stack.mdmarkdown1.4 KB
references/macrostructures/17-type-specimen.mdmarkdown1.2 KB
references/macrostructures/18-portfolio-grid.mdmarkdown1.0 KB
references/macrostructures/19-map-diagram.mdmarkdown1.2 KB
references/macrostructures/20-ecosystem-index.mdmarkdown1.2 KB
references/macrostructures/21-component-playground.mdmarkdown1.1 KB
references/microinteractions.mdmarkdown19.7 KB
references/motion.mdmarkdown4.2 KB
references/preview-examples.mdmarkdown2.8 KB
references/responsive.mdmarkdown5.8 KB
references/slop-test.mdmarkdown30.0 KB
references/structure.mdmarkdown15.7 KB
references/study.mdmarkdown41.8 KB
references/typography.mdmarkdown18.0 KB
references/verbs/audit.mdmarkdown2.7 KB
references/verbs/redesign.mdmarkdown13.5 KB

references/layout-and-space.md

View on GitHub
# Layout and space

Layout is where "AI-generated" gets caught. Equal columns, everything centred, every card identical — these are the tells.

## Principles

- A layout has a **primary axis**. Left-biased, right-biased, top-heavy, or bottom-weighted. Centre-biased is a default, not a choice.
- **Asymmetry reads as intentional.** Symmetry reads as generated. When in doubt, shift.
- **Spacing is a scale, not a value.** Pick one scale. Use it everywhere. Don't type raw px.
- **Varied spacing.** If every gap is 24px, the page is a template. Mix small, medium, and large gaps within the same layout.
- **Break the grid on purpose.** A page with one element crossing the grid is stronger than a page that never does.

## The spacing scale

4pt base. Nine steps. Named by role, not size.

```css
:root {
  --space-3xs: 0.125rem;  /*  2px */
  --space-2xs: 0.25rem;   /*  4px */
  --space-xs:  0.5rem;    /*  8px */
  --space-sm:  0.75rem;   /* 12px */
  --space-md:  1rem;      /* 16px */
  --space-lg:  1.5rem;    /* 24px */
  --space-xl:  2.5rem;    /* 40px */
  --space-2xl: 4rem;      /* 64px */
  --space-3xl: 6rem;      /* 96px */
  --space-4xl: 9rem;      /* 144px */
}
```

- Use `gap` for sibling spacing. It's cleaner than stacked margins, it participates in flex/grid, and it collapses predictably.
- Use `margin` only for optical adjustments or breaking out of the flow. Never `margin` for a list of siblings.

## Grids

- **Prefer CSS Grid** for page layout, **Flexbox** for component internals.
- `grid-template-columns: repeat(auto-fit, minmax(280px, 1fr))` for fluid responsive grids without media queries.
- **Don't default to 3 columns of equal cards with icon-above-heading-above-copy.** This is *the* AI feature-grid. Break it: vary column widths with `grid-template-columns: 1.2fr 1fr 0.8fr`, or use a 12-column underlying grid and give each item a different span, or use 4-up with a 2-span hero, etc.
- Use **named grid areas** for complex layouts and rename them at breakpoints.

## Asymmetry techniques

- **Wide left margin.** Treat the left as a permanent negative space — narrow column of labels, wide column of content. **Labels must NOT be section eyebrows / numbers paired with the heading** — that's gate-66-banned. Reserve this technique for body-level micro-labels (caption, footnote, date) alongside body copy.
- **Hanging headers.** ⚠️ **Opt-in only.** Section labels sit in the left margin; content flows to the right. Permitted only when the user explicitly asks for an editorial / hanging-header layout AND no eyebrow / number / chapter tag sits in the left margin. The eyebrow-left / heading-right pattern is banned by slop-test gate 66 — it's the most reliable templated-editorial AI tell. Default to a stacked single-column section head.
- **Offset grids.** Odd columns wider than even. Or the other way.
- **Grid-breaks.** One element that deliberately extends past a column boundary: a pull-quote, a photograph, a rule, a number.
- **Generous top, tight bottom** (or vice-versa). Sections don't need to be evenly padded.

## Depth

- Depth is **weight and scale**, not shadow. A heavier weight, a larger size, a warmer hue — these create hierarchy better than drop shadows.
- If you use shadow, use one:
  - **Whisper** — `0 1px 2px oklch(20% 0.01 <hue> / 0.05)` for hovering cards.
  - **Hairline** — `0 0 0 1px oklch(30% 0.01 <hue> / 0.06)` as an alternative to a 1px border.
- Never stack multiple shadows. Never use a coloured glow on a light background.
- Z-index has **six levels, named.** Don't freestyle numbers.

```css
:root {
  --z-base:     1;
  --z-raised:   10;
  --z-dropdown: 100;
  --z-sticky:   200;
  --z-modal:    400;
  --z-toast:    500;
  --z-tooltip:  600;
}
```

## Bans

- **Centre-aligned everything.** Headings + body + CTA all centred is the landing-page template every LLM emits.
- **`min-height: 100vh` hero with one centred sentence.** Stop.
- **Card-in-card.** A bordered container inside a bordered container. Pick one.
- **Identical feature grid.** Three columns, three icons, three two-line headings, three three-line bodies. Change *something*.
- **Equal padding on everything.** If the card padding equals the section padding equals the page padding, the rhythm is flat.
- **`z-index: 9999`** and other ad-hoc z values. Use the scale.
- **Shadow-on-dark accidental glow.** A drop shadow on a dark card creates a glow; that's wrong.

## Page-edge clipping

The clipped-edge enrichment archetype (E1) — and any other deliberately overflowing element (full-bleed marquee, oversized headline that exceeds the viewport on small screens, a tilted figure that pushes past a column) — needs a parent that *visually* shows the overflow without letting the document scroll horizontally.

The default is unsafe: a `width: calc(100% + 12vw)` figure inside a section with `overflow: visible` makes the document scroll horizontally on every viewport. The page feels broken on touch devices. Slop-test gate 36 fails on this.

**Always pair clipped-edge with a global clip.** At the top of the stylesheet:

```css
html { overflow-x: clip; }
body { overflow-x: clip; }   /* fallback for older Safari */
```

Use `overflow-x: clip` rather than `overflow-x: hidden`:

- `clip` preserves `position: sticky` and `position: fixed` on descendants.
- `hidden` creates a new scroll container, which breaks sticky and can trap focus on overflowing inputs.

The clipped-edge mockup keeps its visual extension; the page no longer scrolls horizontally. Same pattern works for full-bleed marquees, oversized headlines, and any deliberately-decorative overflow.

The hero or section that *contains* the overflowing element keeps `overflow: visible` (so the figure renders past the parent edge); the global clip on `html` and `body` is the only safety net needed.

## When in doubt

If the layout looks fine but flat, do one of these before shipping:

1. Add one break-out element.
2. Unbalance a column width.
3. Move the primary CTA out of the centre.
4. Remove a card and replace it with negative space.
5. Change one section's padding so the rhythm is uneven.
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: 194kUpdated Claude CodeCodexVerifiedInstall