Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-design

hyper-design

Verified

[Hyper] Use this skill when the user wants interface design work that must not look AI-generated - designing a new screen, page, or component, restyling an existing UI, building faux product UI for a hero, feature card, or demo, or auditing, cleaning, or verifying generic template patterns in an interface - driven by a written design direction, a numeric craft floor, static detection, and evidence-separated review, with briefs and reports saved under `.hyper/design/[slug]/`. Do not use it for backend or data work with no visual surface, accessibility-only or performance-only QA, brand strategy with no interface, or a reusable skill folder.

FileKindSize
SKILL.ko.mdmarkdown24.9 KB
SKILL.mdskill md22.7 KB
assets/design-brief-template.ko.mdmarkdown2.4 KB
assets/design-brief-template.mdmarkdown2.2 KB
assets/detector-config.schema.jsonconfig1.9 KB
assets/evals/contract-cases.jsonlother3.5 KB
assets/evals/detector-cases.jsonlother10.2 KB
assets/evals/hyper-design-cases.jsonlother23.3 KB
assets/fixtures/context/brand-gradient/DESIGN.ko.mdmarkdown170 B
assets/fixtures/context/brand-gradient/DESIGN.mdmarkdown164 B
assets/fixtures/context/brand-gradient/hero.htmlother181 B
assets/fixtures/context/pricing-comparison/pricing.htmlother467 B
assets/fixtures/context/real-status/status.htmlother112 B
assets/fixtures/context/reduced-motion-project/accessibility.cssother75 B
assets/fixtures/context/reduced-motion-project/animation.cssother117 B
assets/fixtures/detector-negative.htmlother352 B
assets/fixtures/detector-positive.htmlother401 B
assets/fixtures/rendered-evidence/dimension-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/fresh.jsonconfig582 B
assets/fixtures/rendered-evidence/invalid.jsonconfig253 B
assets/fixtures/rendered-evidence/measurements.jsonconfig1.3 KB
assets/fixtures/rendered-evidence/no-measurements.jsonconfig367 B
assets/fixtures/rendered-evidence/signature-mismatch.jsonconfig557 B
assets/fixtures/rendered-evidence/stale.jsonconfig556 B
assets/fixtures/rendered-evidence/valid.jsonconfig515 B
assets/fixtures/rendered-evidence/window-frame.jsonconfig558 B
assets/fixtures/reports/all-ids-one-row.ko.mdmarkdown644 B
assets/fixtures/reports/all-ids-one-row.mdmarkdown651 B
assets/fixtures/reports/authorship-claim.ko.mdmarkdown417 B
assets/fixtures/reports/authorship-claim.mdmarkdown403 B
assets/fixtures/reports/empty-reason-evidence.ko.mdmarkdown1.4 KB
assets/fixtures/reports/empty-reason-evidence.mdmarkdown1.3 KB
assets/fixtures/reports/empty-section.ko.mdmarkdown354 B
assets/fixtures/reports/empty-section.mdmarkdown350 B
assets/fixtures/reports/invalid-static-claim.ko.mdmarkdown345 B
assets/fixtures/reports/invalid-static-claim.mdmarkdown341 B
assets/fixtures/reports/missing-wcag-table.ko.mdmarkdown411 B
assets/fixtures/reports/missing-wcag-table.mdmarkdown419 B
assets/fixtures/reports/passing-no-wcag-table.ko.mdmarkdown364 B
assets/fixtures/reports/passing-no-wcag-table.mdmarkdown360 B
assets/fixtures/reports/valid-v2.ko.mdmarkdown379 B
assets/fixtures/reports/valid-v2.mdmarkdown377 B
assets/fixtures/reports/valid-wcag-table.ko.mdmarkdown1.4 KB
assets/fixtures/reports/valid-wcag-table.mdmarkdown1.4 KB
assets/fixtures/reports/wcag-list-no-table.ko.mdmarkdown484 B
assets/fixtures/reports/wcag-list-no-table.mdmarkdown483 B
assets/fixtures/reports/wrong-criterion-id.ko.mdmarkdown1.4 KB
assets/fixtures/reports/wrong-criterion-id.mdmarkdown1.4 KB
assets/fixtures/rules/border-shadow.cssother100 B
assets/fixtures/rules/brand-monospace.htmlother182 B
assets/fixtures/rules/clickable-div.htmlother102 B
assets/fixtures/rules/dead-anchor.htmlother66 B
assets/fixtures/rules/declaration-rules-negative.cssother113 B
assets/fixtures/rules/declaration-rules.cssother91 B
assets/fixtures/rules/decorative-monospace.htmlother125 B
assets/fixtures/rules/decorative-pulse.cssother120 B
assets/fixtures/rules/detector-config-allow.jsonconfig155 B
assets/fixtures/rules/detector-config-invalid.jsonconfig63 B
assets/fixtures/rules/detector-config-motion-off.jsonconfig74 B
assets/fixtures/rules/detector-config-nonstring-allowlist.jsonconfig40 B
assets/fixtures/rules/detector-config-nonstring-rule-value.jsonconfig52 B
assets/fixtures/rules/detector-config-rules.jsonconfig85 B
assets/fixtures/rules/detector-config-unknown-rule.jsonconfig59 B
assets/fixtures/rules/em-dash.htmlother106 B
assets/fixtures/rules/generic-cta.htmlother171 B
assets/fixtures/rules/gradient-border-image-negative.cssother96 B
assets/fixtures/rules/gradient-border-image.cssother131 B
assets/fixtures/rules/grid-background.cssother151 B
assets/fixtures/rules/hard-stop-band-negative.cssother78 B
assets/fixtures/rules/hard-stop-band.cssother86 B
assets/fixtures/rules/identical-icon-cards.htmlother458 B
assets/fixtures/rules/ignore-slop.htmlother286 B
assets/fixtures/rules/inset-stripe-negative.cssother93 B
assets/fixtures/rules/inset-stripe.cssother84 B
assets/fixtures/rules/media-unsized.htmlother132 B
assets/fixtures/rules/motion-without-reduced-motion.cssother121 B
assets/fixtures/rules/naming-rules-negative.htmlother273 B
assets/fixtures/rules/naming-rules.htmlother291 B
assets/fixtures/rules/numbered-section-labels.htmlother275 B
assets/fixtures/rules/pseudo-stripe-negative.cssother209 B
assets/fixtures/rules/pseudo-stripe.cssother181 B
assets/fixtures/rules/radial-glow.cssother100 B
assets/fixtures/rules/repeated-eyebrows.htmlother292 B
assets/fixtures/rules/skipped-heading.htmlother113 B
assets/fixtures/rules/thin-side-stripe-negative.cssother73 B
assets/fixtures/rules/thin-side-stripe.cssother81 B
assets/fixtures/rules/viewport-height.cssother65 B
assets/fixtures/rules/zoom-blocked.htmlother206 B
assets/fixtures/unsupported.txtmarkdown57 B
assets/fixtures/waivers/invalid-global.jsonconfig197 B
assets/report-template.ko.mdmarkdown3.0 KB
assets/report-template.mdmarkdown3.0 KB
assets/waiver.example.jsonconfig280 B
assets/waiver.schema.jsonconfig871 B
references/accessible-interaction.ko.mdmarkdown8.8 KB
references/accessible-interaction.mdmarkdown7.6 KB
references/anti-pattern-catalog.ko.mdmarkdown17.0 KB
references/anti-pattern-catalog.mdmarkdown16.4 KB
references/browser-evidence-schema.ko.mdmarkdown3.2 KB
references/browser-evidence-schema.mdmarkdown2.9 KB
references/chart-artifact.ko.mdmarkdown3.7 KB
references/chart-artifact.mdmarkdown3.2 KB
references/context-signals.ko.mdmarkdown3.0 KB
references/context-signals.mdmarkdown2.8 KB
references/contrast-check.ko.mdmarkdown4.5 KB
references/contrast-check.mdmarkdown4.3 KB
references/eval-rubric.ko.mdmarkdown1.9 KB
references/eval-rubric.mdmarkdown1.8 KB
references/fix-playbook.ko.mdmarkdown5.4 KB
references/fix-playbook.mdmarkdown5.3 KB
references/korean-break-quality.ko.mdmarkdown4.0 KB
references/korean-break-quality.mdmarkdown3.4 KB
references/mockup-craft.ko.mdmarkdown7.4 KB
references/mockup-craft.mdmarkdown6.1 KB
references/native-platforms.ko.mdmarkdown6.8 KB
references/native-platforms.mdmarkdown5.9 KB
references/performance-baseline.ko.mdmarkdown4.2 KB
references/performance-baseline.mdmarkdown3.6 KB
references/print-paged.ko.mdmarkdown4.8 KB
references/print-paged.mdmarkdown4.4 KB
references/rendered-measurements.ko.mdmarkdown4.4 KB
references/rendered-measurements.mdmarkdown3.9 KB
references/replacement-patterns.ko.mdmarkdown2.6 KB
references/replacement-patterns.mdmarkdown2.5 KB
references/responsive-reflow.ko.mdmarkdown7.1 KB
references/responsive-reflow.mdmarkdown6.1 KB
references/screen-patterns.ko.mdmarkdown9.5 KB
references/screen-patterns.mdmarkdown8.1 KB
references/ui-copy.ko.mdmarkdown5.1 KB
references/ui-copy.mdmarkdown4.7 KB
rules/craft-floor.ko.mdmarkdown18.6 KB
rules/craft-floor.mdmarkdown16.2 KB
rules/delivery-gate.ko.mdmarkdown10.5 KB
rules/delivery-gate.mdmarkdown9.4 KB
rules/design-direction.ko.mdmarkdown11.9 KB
rules/design-direction.mdmarkdown10.2 KB
rules/evidence-and-severity.ko.mdmarkdown3.2 KB
rules/evidence-and-severity.mdmarkdown3.2 KB
rules/independent-review.ko.mdmarkdown9.1 KB
rules/independent-review.mdmarkdown8.1 KB
rules/rendered-evidence.ko.mdmarkdown6.3 KB
rules/rendered-evidence.mdmarkdown5.7 KB
rules/safe-editing.ko.mdmarkdown2.9 KB
rules/safe-editing.mdmarkdown2.8 KB
rules/slop-taxonomy.ko.mdmarkdown6.4 KB
rules/slop-taxonomy.mdmarkdown5.9 KB
rules/validation-and-reporting.ko.mdmarkdown6.0 KB
rules/validation-and-reporting.mdmarkdown5.5 KB
rules/waivers-and-baselines.ko.mdmarkdown5.1 KB
rules/waivers-and-baselines.mdmarkdown4.6 KB
rules/workflow.ko.mdmarkdown8.4 KB
rules/workflow.mdmarkdown7.5 KB
scripts/analyze-structure.shexecutablescript3.6 KB
scripts/collect-rendered-evidence.shexecutablescript16.9 KB
scripts/detect-slop.shexecutablescript21.2 KB
scripts/engine-css.shexecutablescript517 B
scripts/engine-markup.shexecutablescript3.7 KB
scripts/engine-text.shexecutablescript563 B
scripts/resolve-context.shexecutablescript3.5 KB
scripts/rule-registry.shexecutablescript15.4 KB
scripts/rule-shared.shexecutablescript20.3 KB
scripts/run-contract-evals.shexecutablescript5.7 KB
scripts/run-detector-evals.shexecutablescript6.9 KB
scripts/validate-report.shexecutablescript12.2 KB
scripts/validate-waivers.shexecutablescript4.5 KB

references/responsive-reflow.md

View on GitHub
# Responsive Reflow

Read when a write mode builds or edits a layout that must hold from phone to desktop, and when an audit finding concerns breakpoints, overflow, tap targets, or mobile navigation. The principle: a mobile layout is a different layout, not the desktop layout at a smaller size. It re-stacks, rescales, and re-orders with intent.

## Contents

- 1. Breakpoints and states
- 2. Scale and sizing
- 3. Grids and stacking
- 4. Overflow
- 5. Tap targets
- 6. Mobile navigation
- 7. Verification

## 1. Breakpoints and States

| Tell | Why | Fix |
|---|---|---|
| One layout for every width; the phone view is the desktop squeezed | Cards collide and text written for a wide canvas crowds a narrow one | Define a real mobile state where the content stops working: columns stack, sizes drop, order changes where needed |
| Breakpoints named after device widths (375, 414, 768) | Devices change every year; the layout follows a spec sheet instead of the content | Narrow the viewport, watch where the content breaks, and put the breakpoint there |
| Mobile rules bolted on as a trailing override | A patch fixes the reported symptom and leaves the next one | Give the narrow width its own deliberate sizes and stacking, and check the whole page there |
| Exactly two states: a phone stack and a wide grid | Tablet and small-laptop widths (about 600-1024px) inherit a stretched stack or a crammed grid | As many states as the content needs, typically single column, two columns, then the full grid |

## 2. Scale and Sizing

| Tell | Why | Fix |
|---|---|---|
| Desktop padding, gaps, hero heights, and card sizes kept on a phone | What reads as confident at 1440px dominates at 375px | A smaller mobile step for type, padding, and gaps; tap targets keep their minimum |
| Font sizes in fixed px that never change | Headings span the whole phone; body lines are tuned for a wide screen | Fluid type with `clamp()` or a smaller type step at the breakpoint |
| Sections at `100vh` | Includes the browser chrome on mobile, overflows the visible area, and pushes content below the fold | Size to content, or `100dvh` where a full-height section is intended |
| Desktop section padding (96-128px) kept on mobile | The page scrolls through empty space | Roughly half or less at the mobile step |

## 3. Grids and Stacking

| Tell | Why | Fix |
|---|---|---|
| Side-by-side columns stay side by side on a phone | Each column becomes a sliver; text wraps badly and cards overlap | Collapse to one column at the breakpoint |
| `grid-template-columns` in fixed px | Tracks keep their width and force overflow | `minmax()` with `auto-fit` or `auto-fill`; grid areas that collapse |
| A 12-column grid forced onto one-column content | Spans become arbitrary fractions of an invisible grid | Let columns follow the content: one, or two at most, on a phone |

## 4. Overflow

| Tell | Why | Fix |
|---|---|---|
| The page scrolls sideways because a table, code block, image, or long string is wider than the viewport | The user cannot see where the page ends; it is invisible in the desktop preview | Find the wide element: `max-width: 100%` on media, wrapping code, a reflowed or scroll-contained table; zero horizontal scroll at the narrowest width |
| `overflow: hidden` clips text or controls at narrow widths or at 200% zoom | Hides a failure and removes content | Let the container grow, wrap, or collapse; clip only deliberate crops such as thumbnails |
| Flex or grid children with fixed px `width` or `min-width` | The child keeps its desktop size and bursts out | Relative widths, `flex-wrap`, and `min-width: 0` on grid and flex children |

## 5. Tap Targets

| Tell | Why | Fix |
|---|---|---|
| Controls smaller than the touch floor | A thumb is not a cursor | WCAG 2.2 AA requires 24×24 CSS px; on touch surfaces aim for 44×44 (Apple default, WCAG AAA) or 48×48 dp on Android, using padding or a larger hit box when the visual is smaller |
| Large targets packed with no gap | Two touching controls behave like one | A clear gap so the press area of one never covers the next |
| Menus, reveals, and tooltips that exist only on hover | There is no hover on a touchscreen | A tap equivalent for every hover interaction, with visible `:active` feedback |

## 6. Mobile Navigation

| Tell | Why | Fix |
|---|---|---|
| The desktop row of links kept on a phone | Links crowd, wrap, or spill past the edge | Collapse at the breakpoint: a bottom bar for a handful of primary destinations, a menu for the rest |
| A bare hamburger icon hides everything | The user may not know a menu exists or what it holds | Label it ("Menu"), or keep primary destinations visible and hide only the secondary ones |
| A fixed bottom bar covers the last items or the final button | Content scrolls under the bar and becomes unreachable | Reserve the bar's height with padding and `env(safe-area-inset-bottom)` |
| A tall sticky header takes a large slice of the screen | The content becomes a letterbox | Keep fixed chrome compact; shrink or hide it on scroll where suitable |

## 7. Verification

Drag the viewport through the whole range, not two sample widths. Record the widths checked, the horizontal-scroll result at the narrowest width, and the last reachable item under any fixed bar. Without a rendered capture, these items are `static_only`.

## Sources

> Checked 2026-11-07.

| Claim | Source |
|---|---|
| The reflow principle and every Tell / Why / Fix row in §1-§6 | <https://github.com/miqdadbadjuber/anti-slop> (commit `9504989`, `antislop-layoutmobile/SKILL.md`; MIT, Copyright 2026 Miqdad Badjuber), rewritten for this package |
| Target size 24×24 CSS px (AA) and 44×44 CSS px (AAA); reflow at 320px | <https://www.w3.org/TR/2024/REC-WCAG22-20241212/> (SC 2.5.8, 2.5.5, 1.4.10). The source states 44px as the minimum; this package keeps the AA and AAA levels apart. |
| Apple 44×44 pt default control size; Android 48×48 dp | <https://developer.apple.com/design/human-interface-guidelines/accessibility>, <https://developer.android.com/guide/topics/ui/accessibility/apps> |

### Evidence grade

The WCAG rows are normative. The rest is a practitioner rule set; the source gives no measurements.
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: 469kUpdated 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: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated 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