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/accessible-interaction.md

View on GitHub
# Accessible Interaction

Read when a write mode builds or edits controls, forms, dialogs, tabs, or dynamic content, and when an audit finding concerns a control's role, name, state, or keyboard use. Each entry is Tell, Why, Fix; the code is a starting shape to adapt to the project's stack, not a library to paste.

## Contents

- 1. Affordances
- 2. Keyboard and focus
- 3. Forms and errors
- 4. Dynamic content
- 5. Whole documents
- 6. Code shapes

## 1. Affordances

| Tell | Why | Fix |
|---|---|---|
| A button, `summary`, checkbox label, or `[role="button"]` keeps the arrow cursor (often after a CSS reset sets `button { cursor: default }`) | The arrow says "this is text"; people hesitate or never click | One base rule after the reset gives every enabled control `cursor: pointer` and disabled controls `cursor: not-allowed` (§6.1); never on something that does nothing |
| `<div onClick>`, `<span onClick>`, `<a>` without `href`, or `<a href="#" onClick>` used for an action | No role, so screen readers do not announce a control and the keyboard skips it | Actions are `<button type="button">`; navigation is `<a href>` to a real destination; a custom control that cannot be native gets a role, its state attributes, and full keyboard support |
| An icon-only close, menu, search, or social button with no text | A screen reader says "button" and nothing else; voice control cannot name it | An `aria-label` or visually hidden text matching the visible meaning; the icon gets `aria-hidden="true"` |
| A control looks the same at rest, on hover, pressed, and disabled; a grayed-out button still fires | No feedback that the action registered; a disabled control looks broken | Distinct `:hover`, `:active`, `:focus-visible`, and disabled styles held to 3:1; prefer the `disabled` attribute, or `aria-disabled="true"` plus a code-level block when it must stay focusable |
| Status shown by color alone: a red border, a green chip | Excludes color-blind users and vanishes in forced-colors mode | Pair every color signal with text or an icon; error text first |
| Drag is the only way to reorder, resize, or pick a value | Fails people who cannot drag (WCAG 2.5.7) | Offer a click, tap, or keyboard path: move-up and move-down buttons, a number input beside a slider |

## 2. Keyboard and Focus

| Tell | Why | Fix |
|---|---|---|
| `outline: none` with no replacement | Keyboard users lose their place | A `:focus-visible` style with 3:1 against neighbors, in every theme |
| Menus open on hover only; a dropdown opens by click but not by keyboard | The control does not exist for keyboard and touch users | Every interactive element works with Tab, Shift+Tab, Enter, and Space; dialogs close with Escape |
| Focus jumps around because DOM order differs from visual order | Navigation is unpredictable | Keep source order equal to visual order; add a skip link on long pages (§6.2); give real content `tabindex="-1"` only inside a controlled focus target |
| A custom modal lets Tab escape behind it | Keyboard users end up in the hidden page | Prefer the native `<dialog>` with `showModal()`, which traps focus and closes on Escape; return focus to the opener on close |
| Tabs built from plain buttons with no roles | Screen readers cannot tell which panel is shown | `role="tablist"`, `role="tab"` with `aria-selected` and `aria-controls`, `role="tabpanel"`; arrow keys move between tabs, the active tab has `tabindex="0"`, the others `-1` |

## 3. Forms and Errors

- Every field has a visible `<label for>` (or a wrapping label); a placeholder is a hint, never the label. Use `autocomplete` tokens for personal data.
- Instructions that apply before typing sit above or beside the field and are tied with `aria-describedby`.
- Validate on submit or on leaving a field the user has changed, never on focus. Mark the field `aria-invalid="true"`, show the message next to it, keep the input, and say how to fix it in plain words.
- A form with several fields shows an error summary at the top on submit, moves focus to it, and links each line to its field; the wording matches the inline messages.
- On a phone, the focused field scrolls into view above the on-screen keyboard; leave enough bottom padding that the keyboard never covers it.

## 4. Dynamic Content

- Content that changes without a page load (a saved toast, a result count, an upload finished) is announced through a live region that exists before the change: `aria-live="polite"` for status, `role="alert"` only for urgent errors.
- Clear a live region, then write the new text on the next frame, so the same message repeated is announced again.
- Loading text says what is loading ("Loading invoices"), not only a spinner.

## 5. Whole Documents

Apply only when the task produces a full page or an app shell, never to a single component:

- `<html lang>` set to the content language, a unique `<title>`, and landmarks: `header`, `nav`, `main`, `footer`.
- One `h1` and no skipped heading levels.
- The viewport meta never blocks zoom.

## 6. Code Shapes

### 6.1 Pointer cursor base layer

```css
@layer base {
  :where(a[href], button, summary, select, label[for],
         input:is([type="checkbox"], [type="radio"], [type="file"], [type="range"],
                  [type="color"], [type="submit"], [type="button"], [type="reset"]),
         [role="button"], [role="link"], [role="tab"], [role="switch"],
         [role="menuitem"], [role="option"]) {
    cursor: pointer;
  }
  :where(label:has(> input:is([type="checkbox"], [type="radio"]))) { cursor: pointer; }
  :where(:disabled, [aria-disabled="true"]) { cursor: not-allowed; }
}
```

Text inputs keep `cursor: text`; drag handles use `grab` and `grabbing`. In Tailwind, place this after the preflight layer.

### 6.2 Skip link

```html
<a class="skip-link" href="#main">Skip to content</a>
<main id="main" tabindex="-1">…</main>
```

```css
.skip-link { position: absolute; inset-inline-start: 0.5rem; translate: 0 -200%; }
.skip-link:focus-visible { translate: 0 0.5rem; }
```

### 6.3 Native dialog

```html
<button type="button" aria-haspopup="dialog" aria-controls="rename">Rename</button>
<dialog id="rename" aria-labelledby="rename-title">
  <h2 id="rename-title">Rename project</h2>
  <form method="dialog">
    <label for="rename-name">Name</label>
    <input id="rename-name" name="name" required>
    <button value="cancel" formnovalidate>Cancel</button>
    <button value="save">Save</button>
  </form>
</dialog>
```

Open it with `dialog.showModal()`, which traps focus and closes on Escape; move focus back to the opener in the `close` event.

## Sources

> Checked 2026-11-07.

| Claim | Source |
|---|---|
| The affordance entries (pointer cursor base layer, native elements, accessible names, distinct states, color-only feedback, page semantics only for whole documents) and the pattern list (focus trap, skip link, error handling, labels, dragging alternatives, tabs, live regions) | <https://github.com/miqdadbadjuber/anti-slop> (commit `9504989`, `antislop-human/SKILL.md` and its `references/A11Y-PATTERNS.md`; MIT, Copyright 2026 Miqdad Badjuber; the patterns file is adapted from <https://github.com/addyosmani/web-quality-skills>, MIT, Copyright 2026 Addy Osmani). The code in §6 was written for this package, not copied. |
| Name, role, value; keyboard operability; focus visible; dragging movements; status messages | <https://www.w3.org/TR/2024/REC-WCAG22-20241212/> (SC 4.1.2, 2.1.1, 2.4.7, 2.5.7, 4.1.3) |
| The native `dialog` element traps focus in `showModal()` and closes on Escape | <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog> |

### Evidence grade

The WCAG criteria are normative. The pointer cursor rule is a widely used convention, not a WCAG requirement, and is held as a default.
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