taste-lint 0.0.1

package/data/rules/copywriting/copywriting-vague-error.yaml

@@ -0,0 +1,58 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/microcopy-vague-error.md.
+id: copywriting-vague-error
+title: Error message with no cause and no next step
+categoryId: actionable-microcopy
+source:
+  line: 10
+  path: skills/ui-design/rules/microcopy-vague-error.md
+  repo: mblode/agent-skills
+  ruleId: microcopy-vague-error
+unit:
+  - jsx-text
+  - attr-string
+mechanical:
+  phrases:
+    - error occurred
+    - an error has occurred
+    - something went wrong
+    - please try again
+    - try again later
+    - oops
+    - invalid
+    - unexpected error
+    - an error occurred
+    - failed
+question:
+  context:
+    - element
+    - docType
+  instructions: The TEXT is a message shown to a user after something failed. Return true when it tells the user neither what went wrong nor what to do next (for example "Something went wrong", "Invalid", "An error occurred. Please try again."). Return false when it names the cause or the recovery (what failed, what to check, where to go), when it is a sign-in credential message that is deliberately vague for security ("Wrong email or password"), or when the TEXT is not an error message at all.
+  criteria:
+    "true":
+      what: No cause and no recovery.
+      examples:
+        - Something went wrong
+        - Invalid
+        - Oops! An error occurred. Please try again.
+    "false":
+      what: Cause or recovery named, or a deliberate security message.
+      examples:
+        - Email already in use. Sign in instead.
+        - Couldn't reach the payment provider. Your card was not charged. Try again.
+        - Wrong email or password.
+severity: major
+fix:
+  hint: Write what happened, why when you know it, and the next step. Never blame the person and never clear the form.
+preconditions:
+  notInCode: true
+  docType:
+    - ui
+    - unknown
+    - lesson
+status: review-only
+handWritten:
+  - mechanical
+  - question
+  - fix
+  - severityOverrides
+  - preconditions

package/data/rules/copywriting/copywriting-vague-personal-request.yaml

@@ -0,0 +1,43 @@
+id: copywriting-vague-personal-request
+title: Personal request has an unspecified time expectation
+categoryId: actionable-microcopy
+source:
+  repo: mblode/ghostwriter
+  path: skills/ghostwriter/references/strategy.md
+  line: 1
+unit:
+  - paragraph
+  - jsx-text
+  - attr-string
+mechanical:
+  regex: \b(?:ASAP|soon|when you get a chance)\b
+  flags: giu
+question:
+  context:
+    - docType
+    - headingAbove
+    - role
+    - element
+  instructions: Return true when a request uses a vague urgency phrase that makes its timing unclear. Return false for a deliberately open-ended invitation, quoted wording, or when the supplied text already names a concrete deadline. Never invent a deadline.
+  criteria:
+    "true":
+      what: The stated failure is supported by the supplied text.
+      examples:
+        - Please send the launch review ASAP.
+    "false":
+      what: The text is specific, justified, quoted, or outside this rule.
+      examples:
+        - Send the launch review by Thursday at noon.
+severity: minor
+fix:
+  hint: Use the actual deadline if known; otherwise clarify urgency without inventing a time.
+preconditions:
+  notInCode: true
+  docType:
+    - personal
+status: review-only
+handWritten:
+  - mechanical
+  - question
+  - preconditions
+  - fix

package/data/rules/copywriting/copywriting-visual-direction-instruction.yaml

@@ -0,0 +1,43 @@
+id: copywriting-visual-direction-instruction
+title: UI instruction depends on visual position
+categoryId: actionable-microcopy
+source:
+  repo: installed/copywriting
+  path: skills/copywriting/references/ui-states.md
+  line: 1
+unit:
+  - paragraph
+  - jsx-text
+  - attr-string
+mechanical:
+  regex: \b(?:above|below|left|right)\b
+  flags: giu
+question:
+  context:
+    - docType
+    - headingAbove
+    - role
+    - element
+  instructions: Return true only when an instruction identifies a control solely by visual position, without naming the control or a semantic destination. Return false for named controls, keyboard arrow instructions, descriptions of physical directions, or text where position is the information requested.
+  criteria:
+    "true":
+      what: The stated failure is supported by the supplied text.
+      examples:
+        - Click the button on the right.
+    "false":
+      what: The text is specific, justified, quoted, or outside this rule.
+      examples:
+        - Select Save changes.
+severity: minor
+fix:
+  hint: Name the control or destination so the instruction works without seeing the layout.
+preconditions:
+  notInCode: true
+  docType:
+    - ui
+status: review-only
+handWritten:
+  - mechanical
+  - question
+  - preconditions
+  - fix

package/data/rules/craft/craft-affordance-mismatch.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/slop-affordance-mismatch.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-affordance-mismatch
+title: Affordance styling with nothing behind it
+categoryId: generic-decoration
+source:
+  line: 10
+  path: skills/ui-design/rules/slop-affordance-mismatch.md
+  repo: mblode/agent-skills
+  ruleId: slop-affordance-mismatch
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: cursor-pointer|hover:(bg|shadow|scale|border|ring|translate)-
+severity: minor
+fix:
+  hint: A card lifts on hover, the cursor turns into a hand, the border brightens, and clicking does nothing. The user has already committed to the click by the time they learn it was a decoration; they click again, assume the page is broken or slow, and then trust the next hover state less. This is worse t
+status: review-only

package/data/rules/craft/craft-decoration-no-role.yaml

@@ -0,0 +1,27 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/slop-decoration-no-role.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+id: craft-decoration-no-role
+title: Stacked decorative layers with no role
+categoryId: generic-decoration
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/slop-decoration-no-role.md
+  line: 10
+  ruleId: slop-decoration-no-role
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit: [source]
+mechanical:
+  flags: gus
+  regex:
+    "<(?:div|span)\\b(?=[^>]*?(?:\\babsolute\\b|\\bfixed\\b))(?=[^>]*?(?:pointer-events-none|ari\
+    a-hidden))(?=[^>]*?(?:gradient|bg-linear|bg-radial|\\bblur|backdrop-blur|mix-blend|opacity-))(?\
+    ![^>]*?(?:size-\\[max\\(100%|pointer-fine:hidden|bg-clip-text|\\bmask-))[^>]*?/>"
+severity: minor
+fix:
+  hint: >-
+    A blurred blob, a grid overlay, a noise layer and a radial glow behind the heading: absolutely positioned elements that contain nothing and mean nothing. Cut them until each remaining layer has a job a reader could name.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/craft/craft-faux-product-chrome.yaml

@@ -0,0 +1,22 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/slop-faux-product-chrome.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-faux-product-chrome
+title: Faux product chrome wrapping nothing
+categoryId: generic-decoration
+source:
+  line: 10
+  path: skills/ui-design/rules/slop-faux-product-chrome.md
+  repo: mblode/agent-skills
+  ruleId: slop-faux-product-chrome
+scope:
+  include:
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: rounded-full[^"`]*\bbg-(red|rose|yellow|amber|green|emerald)-[45]00
+severity: minor
+fix:
+  hint: "Three coloured dots in a row, a rounded bar with a URL typed into it, a laptop outline around an empty gradient panel: this is a drawing of a product where the product should be. A visitor reads it as a screenshot, leans in to see what the app actually looks like, and finds there is nothing to see. "
+status: review-only

package/data/rules/craft/craft-hover-only-affordance.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/mobile-hover-only-affordance.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-hover-only-affordance
+title: Critical actions hidden behind hover-only affordances
+categoryId: resilience
+source:
+  line: 10
+  path: skills/ui-design/rules/mobile-hover-only-affordance.md
+  repo: mblode/agent-skills
+  ruleId: mobile-hover-only-affordance
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: (group-hover|peer-hover|\bhover:):(opacity-100|visible|flex|block)
+severity: minor
+fix:
+  hint: 'Reveal-on-hover quietly disappears on touch: a row exposes "Edit / Delete / Share" only when the cursor enters, but a phone has no cursor. Touch users never discover the actions, or only via a frustrating long-press. The same pattern hides tooltips, secondary CTAs, and meaningful state ("3 unread") '
+status: review-only

package/data/rules/craft/craft-i18n-rtl-untested.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/dark-i18n-rtl-untested.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-i18n-rtl-untested
+title: Layout uses physical (left/right) instead of logical (start/end) properties
+categoryId: resilience
+source:
+  line: 10
+  path: skills/ui-design/rules/dark-i18n-rtl-untested.md
+  repo: mblode/agent-skills
+  ruleId: dark-i18n-rtl-untested
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: className="[^"]*\b(ml-|mr-|pl-|pr-|left-|right-|text-(left|right)|float-(left|right)|border-(l|r))\b
+severity: minor
+fix:
+  hint: 'Arabic, Hebrew, Persian, and Urdu read right-to-left. A layout using physical properties (`margin-left`, `padding-right`, `text-align: left`, Tailwind `ml-2`, `pr-4`, `text-left`) does not flip when document direction is `rtl`: icons land on the wrong side, "forward" chevrons point backward, padding'
+status: review-only

package/data/rules/craft/craft-i18n-untested.yaml

@@ -0,0 +1,28 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/dark-i18n-untested.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# The source filters matching lines through `rg -v dark:`; the negative lookahead is
+# that filter on the same line.
+id: craft-i18n-untested
+title: Hardcoded light-mode token with no dark variant on the line
+categoryId: resilience
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/dark-i18n-untested.md
+  line: 10
+  ruleId: dark-i18n-untested
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gum
+  regex:
+    "^(?!.*dark:).*className=\"[^\"]*\\b(?:bg-white|bg-black|text-black|text-white|bg-gray-\\d{2\
+    ,3}|text-gray-\\d{2,3}|border-gray-\\d{2,3})\\b[^\"]*\".*$"
+severity: minor
+fix:
+  hint: >-
+    bg-white, text-black and fixed grays break in dark mode: white surfaces glow, grays lose contrast, borders vanish. Use the semantic tokens (bg-background, text-foreground, border-border) or pair each with a dark: variant.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/craft/craft-image-dimensions-and-priority.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/perf-image-dimensions-and-priority.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-image-dimensions-and-priority
+title: Set Image Dimensions and Priority Intentionally
+categoryId: resilience
+source:
+  line: 9
+  path: skills/ui-design/rules/perf-image-dimensions-and-priority.md
+  repo: mblode/agent-skills
+  ruleId: perf-image-dimensions-and-priority
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <img\b(?![^>]*\bwidth=)[^>]*>
+severity: major
+fix:
+  hint: Declare `width`/`height` (or aspect ratio) and prioritize only above-the-fold hero images. Undeclared dimensions shift the page as images arrive, and an unprioritized hero delays the largest paint.
+status: review-only

package/data/rules/craft/craft-inline-styles.yaml

@@ -0,0 +1,24 @@
+# Hand-authored from shadcn-ui/lint (shadcn/no-inline-styles). The rule is re-expressed over
+# taste-lint's extracted class lists; the original runs as an ESLint or oxlint plugin.
+id: craft-inline-styles
+title: Inline style object or style element in a component
+categoryId: look-constraints
+source:
+  repo: shadcn-ui/lint
+  path: README.md
+  line: 1
+  ruleId: shadcn/no-inline-styles
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+  exclude:
+    - "**/components/ui/**"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: "style=\\{\\{|<style\\b"
+severity: minor
+fix:
+  hint: >-
+    Move the styling into utility classes or the theme. Inline styles bypass the design tokens, dark mode and the linter alike.
+status: review-only
+handWritten: [mechanical, fix, status, scope]

package/data/rules/craft/craft-lazy-load-offscreen.yaml

@@ -0,0 +1,28 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/perf-lazy-load-offscreen.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# The source's `(?i:hero|banner|...)` inline modifier is written out as letter
+# classes so the regex compiles on Node 22 and 24 alike.
+id: craft-lazy-load-offscreen
+title: Hero or above-the-fold image marked loading lazy
+categoryId: resilience
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/perf-lazy-load-offscreen.md
+  line: 9
+  ruleId: perf-lazy-load-offscreen
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit: [source]
+mechanical:
+  flags: gus
+  regex:
+    "<(?:img|Image)\\b(?=[^>]*loading=\"lazy\")(?=[^>]*(?:[Hh]ero|[Bb]anner|[Cc]over|[Mm]asthead\
+    |[Pp]riority))[^>]*>"
+severity: minor
+fix:
+  hint: >-
+    Never lazy-load the largest above-the-fold image; it delays the largest contentful paint. Load the hero eagerly (priority) and keep loading="lazy" for images below the fold.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/craft/craft-near-duplicate-scale.yaml

@@ -0,0 +1,29 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/slop-near-duplicate-scale.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# Nudges of 2px or less are excluded in the regex, as the source's second filter does.
+# The source asks for a theme precondition; this port has none and stays review-only.
+id: craft-near-duplicate-scale
+title: Arbitrary pixel value one step off the scale
+categoryId: look-constraints
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/slop-near-duplicate-scale.md
+  line: 10
+  ruleId: slop-near-duplicate-scale
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex:
+    "\\b(?:text|p|px|py|pt|pb|pl|pr|m|mt|mb|ml|mr|mx|my|gap|gap-[xy]|space-[xy]|rounded(?:-[a-z]\
+    +)?|leading|w|h|size|inset|top|bottom|left|right)-\\[(?!-?(?:[01](?:\\.\\d+)?|2(?:\\.0+)?)px\\]\
+    )-?\\d+(?:\\.\\d+)?px\\](?!:)"
+severity: minor
+fix:
+  hint: >-
+    text-[15px] beside text-sm and text-base is a third size that reads as a mistake, not a level. Step the scale, or register the value in the theme when it recurs. Check the theme first: with no scale defined there is nothing to be a near-duplicate of.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/craft/craft-token-drift.yaml

@@ -0,0 +1,22 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/slop-token-drift.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-token-drift
+title: Arbitrary values drifting off the theme
+categoryId: look-constraints
+source:
+  line: 10
+  path: skills/ui-design/rules/slop-token-drift.md
+  repo: mblode/agent-skills
+  ruleId: slop-token-drift
+scope:
+  include:
+    - "**/*.css"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: "@theme"
+severity: minor
+fix:
+  hint: "A theme exists so that sizes, colours, and radii repeat across a product and the eye reads them as one system. When a file reaches for five or six one-off bracket values, the surface stops agreeing with the rest of the app: headings land at sizes no other heading uses, a card corner is 3px rounder t"
+status: review-only

package/data/rules/craft/craft-viewport-scaling.yaml

@@ -0,0 +1,25 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/mobile-viewport-scaling.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-viewport-scaling
+title: Missing viewport meta, 100vh on mobile, no safe-area insets
+categoryId: resilience
+source:
+  line: 10
+  path: skills/ui-design/rules/mobile-viewport-scaling.md
+  repo: mblode/agent-skills
+  ruleId: mobile-viewport-scaling
+scope:
+  include:
+    - "**/*.md"
+    - "**/*.mdx"
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: export const viewport|<meta name="viewport"
+severity: minor
+fix:
+  hint: 'Three quiet bugs ship together on mobile, each a one-line fix invisible in desktop testing: a missing `<meta name="viewport">` makes iOS Safari render at 980 px and zoom out; `100vh` includes the address bar (~60 px wrong on iOS); a fixed bottom bar covers the home-indicator notch and clips content.'
+status: review-only

package/data/rules/craft/craft-virtualize-large-lists.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/perf-virtualize-large-lists.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: craft-virtualize-large-lists
+title: Virtualize Long Lists
+categoryId: resilience
+source:
+  line: 9
+  path: skills/ui-design/rules/perf-virtualize-large-lists.md
+  repo: mblode/agent-skills
+  ruleId: perf-virtualize-large-lists
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: react-window|@tanstack/react-virtual|react-virtuoso|virtua
+  flags: gus
+  regex: <(?:ul|ol|tbody)\b[^>]*>\s*\{[^}]*\.map\(
+severity: minor
+fix:
+  hint: Large lists (roughly >50 visible items) should use virtualization/windowing. Rendering the whole dataset stalls scrolling and grows memory with the list.
+status: review-only

package/data/rules/interaction/interaction-a11y-color-only-meaning.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-color-only-meaning.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-color-only-meaning
+title: Avoid Color-Only Meaning
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-color-only-meaning.md
+  repo: mblode/agent-skills
+  ruleId: a11y-color-only-meaning
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: \?[^:]*\b(text|bg|border)-(red|green|amber|emerald|rose|yellow)-\d
+severity: major
+fix:
+  hint: State carried by hue alone (a red row, a green dot, a colored border) is invisible to color-blind users and on washed-out screens. Pair color with text, an icon, or shape. Contrast ratios are axe's job, not this rule's.
+status: review-only

package/data/rules/interaction/interaction-a11y-data-table-semantics.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-data-table-semantics.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-data-table-semantics
+title: Mark Up Data Tables With Real Table Semantics
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-data-table-semantics.md
+  repo: mblode/agent-skills
+  ruleId: a11y-data-table-semantics
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: <caption\b|scope="(col|row)"
+  flags: gu
+  regex: <table\b|role="(table|grid)"
+severity: major
+fix:
+  hint: Tabular data needs a real `<table>` with `<caption>`, header cells, and `scope`. Divs styled as a grid carry no row/column relationships, so screen readers read cells as a flat list. (Layout-only grids use CSS, not `<table>`.)
+status: review-only

package/data/rules/interaction/interaction-a11y-disabled-control-tooltip.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-disabled-control-tooltip.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-disabled-control-tooltip
+title: Do not put tooltips on disabled controls
+categoryId: focus-and-a11y
+source:
+  line: 10
+  path: skills/ui-design/rules/a11y-disabled-control-tooltip.md
+  repo: mblode/agent-skills
+  ruleId: a11y-disabled-control-tooltip
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <[^>]*\bdisabled\b[^>]*>[\s\S]{0,400}<(Tooltip|HoverCard)
+severity: minor
+fix:
+  hint: "A tooltip on a `disabled` button never reaches keyboard or screen-reader users: disabled controls are omitted from the tab order, so the reason the action is blocked is invisible. Mouse users see a hover hint; everyone else hits a dead control with no explanation."
+status: review-only

package/data/rules/interaction/interaction-a11y-document-language.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-document-language.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-document-language
+title: Declare Document and Inline Language
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-document-language.md
+  repo: mblode/agent-skills
+  ruleId: a11y-document-language
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+    - "**/*.html"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <html(?![^>]*\blang=)[^>]*>
+severity: major
+fix:
+  hint: Set the primary language on `<html lang>` with a valid BCP 47 tag, and mark any inline passage in another language with its own `lang`. Without it, a screen reader reads everything with one pronunciation engine.
+status: review-only

package/data/rules/interaction/interaction-a11y-icon-controls-labeled.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-icon-controls-labeled.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-icon-controls-labeled
+title: Label Icon-Only Controls
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-icon-controls-labeled.md
+  repo: mblode/agent-skills
+  ruleId: a11y-icon-controls-labeled
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <button\b(?![^>]*(aria-label|aria-labelledby|title=))[^>]*>\s*<[A-Z][\w.]*[^>]*/>\s*</button>
+severity: minor
+fix:
+  hint: Any control with no visible text requires an accessible name. Without one, assistive tech announces nothing usable and the control cannot be identified.
+status: review-only

package/data/rules/interaction/interaction-a11y-image-alt-text.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-image-alt-text.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-image-alt-text
+title: Give Every Image a Correct Alt Attribute
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-image-alt-text.md
+  repo: mblode/agent-skills
+  ruleId: a11y-image-alt-text
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+    - "**/*.html"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <img\b(?![^>]*\balt=)[^>]*>
+severity: major
+fix:
+  hint: 'Every `<img>` needs an `alt`: describe the purpose for informative images, use an empty `alt=""` for decorative ones so screen readers skip them. A missing `alt` makes the file name get read aloud. The `alt` is also what renders when the image itself fails to load.'
+status: review-only

package/data/rules/interaction/interaction-a11y-media-captions.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-media-captions.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-media-captions
+title: Caption Video and Transcribe Audio
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-media-captions.md
+  repo: mblode/agent-skills
+  ruleId: a11y-media-captions
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: kind="captions"
+  flags: gu
+  regex: <video\b|<audio\b
+severity: major
+fix:
+  hint: Deaf and hard-of-hearing users get nothing from uncaptioned media. Video needs synchronised captions via `<track kind="captions">`; audio-only needs a text transcript. Auto-generated captions alone are not sufficient for meaning-critical media.
+status: review-only