Index of every page on this site: llms.txt
All skills
raphaelsalaja avatar

/viewports

@b2e4283
Run it yourself

Renders a page at every width, each breakpoint edge, a short landscape phone, 400% zoom, 200% text and spaced, longer, shorter, unbroken or mirrored text, then reports what overflows, clips or hides.

Use this Skill: https://skilld.dev/gh/raphaelsalaja/skills/viewports

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈53 tokens for metadata: the name and description. ≈3.1k when used: this file. ≈25 more on demand in 1 file.

Description uses 2.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈211 characters, or 2.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Viewports

This skill renders one page at a fixed set of widths and heights. It measures each render for sideways scroll, clipped text, small targets and controls that only hover reveals.

Every width rendered, none inferred

The widths are exact: 320, 375, 768, 1024, 1440 and 2560, plus each project breakpoint and the width 1px below it. The short sizes are exact too: 812×375 for a phone held sideways and 320×256 for 400% zoom. A width reasoned from the media queries is a finding. Run it after any layout change and whenever the user names a phone or a width.

Opening the result belongs to verify. Alignment inside one render belongs to alignment. Safe areas, hit areas and dynamic viewport units belong to defaults, and a failure there cites its id.

1. Read the breakpoints

Read the breakpoints from the CSS, the Tailwind config or the tokens. Add each one and the width 1px below it to the fixed widths. A sweep that skips the edges of a breakpoint is viewports-cross-each-breakpoint.

Run overflow.js once through the browser's evaluate call. Its breakpoints field reads every width query in the loaded stylesheets. It lists widths, the edges to render and the gaps. Queries set only from JavaScript, such as matchMedia, never show there.

Each entry in gaps is a max-width up to 1px below another query's min-width. A max-width: 767px beside a min-width: 768px leaves 767.5px matching neither, and browser zoom or fractional display scaling lands there. That gap is viewports-no-breakpoint-gap. Write the pair in range syntax, (width < 768px) and (width >= 768px).

2. Render each width

Set the viewport through device emulation at each width. Use 320×568, 375×812, 768×1024, 1024×768, 1440×900 and 2560×1440. Breakpoint edges render 800px tall. Emulate touch at every width under 1024. Take a full-page screenshot of each. A layout judged from the code is viewports-render-every-width.

At 375×812, set the safe-area insets through Emulation.setSafeAreaInsetsOverride to 59px top and 34px bottom. At 812×375 they are 59px left and right and 21px bottom. Clear them with empty insets before the other widths. A bar or button drawn under an inset cites defaults-safe-areas.

At 2560 the content sits centred in its column or uses the width on purpose. A 1200px column pinned left with 1360px of blank space beside it is viewports-widest-width.

A component that ships inside a narrower container also renders at that container's width. Render it inside its real parent, or set its wrapper to that width. A list checked at 1440 that ships in a 280px sidebar is viewports-container-width.

3. Measure each render

Run overflow.js through the browser's evaluate call at each width. Treat each result as a candidate until a crop of that width shows it.

The page never scrolls sideways, though a box may scroll inside itself. A 40px sideways scroll at 320 is viewports-no-sideways-scroll.

At 1440, set window.__viewportsOptions = { scrollbar: true } and run the script again. It draws the classic 15px scrollbar that macOS and touch emulation hide, and its scrollbar field reads 15 when that took effect. Delete window.__viewportsOptions afterwards, or every later run draws it too. A width: 100vw band 15px wider than the page is viewports-classic-scrollbar. Search the CSS for 100vw and use width: 100%. A centred column that jumps 15px between a short page and a long one cites defaults-scrollbar-gutter.

Text is never cut by its box without an ellipsis or a clamp. A button label cut in half at 375 is viewports-no-clipped-text. A target under 24px cites defaults-hit-area.

4. Tap at touch widths

Tap through the page with touch emulated. Row actions, copy buttons and menus that appear on hover need another way to appear. A delete button that shows only on row hover is viewports-no-hover-only-controls.

5. Shorten the height

Render 812×375, a phone held sideways. The page works in both orientations and never asks to be turned. A "Rotate your device" overlay at 812×375 is viewports-both-orientations.

Open each dialog, sheet and menu at that size. Content scrolls inside the overlay and its actions stay reachable. A dialog whose Save sits below the screen with no scroll is viewports-short-heights.

Search the CSS for 100vh and h-screen. A match on an app shell or a full-height panel cites defaults-dynamic-viewport.

6. Zoom to 400%

Render 320×256 at a device scale factor of 4, which is a 1280×1024 window zoomed to 400%. Run overflow.js again. Text reflows with no sideways scroll.

Under 480px of height, fixed and sticky bars together cover at most a quarter of the screen, 64px at 256. Bars that need more stop sticking there. A 56px sticky header above a 56px fixed tab bar, covering 112px of 256, is viewports-unstick-when-short.

7. Double the text

At 1024 wide, set the root font size to 200% and render again. Text wraps and its boxes grow, with nothing overlapping. Labels overlapping their icons at 200% is viewports-text-zoom. A root font size in px that stops the text growing cites defaults-rem-sizes.

8. Widen the spacing

At 375 and 1024, run stretch.js through the browser's evaluate call, then call window.__stretch.run("spacing"). Line height becomes 1.5 times the font size and paragraph spacing 2 times. Letter spacing becomes 0.12em and word spacing 0.16em. Nothing clips or overlaps. A tag with height: 32px cutting its label is viewports-text-spacing.

9. Lengthen and shorten the text

At 375 and 1440, run stretch.js. It doubles labels under 11 characters and lengthens longer text by 40–60%, as translation does. Labels wrap or truncate with a way back. A tab label pushing its neighbour off the bar is viewports-longer-text.

Then call window.__stretch.run("unbreakable") for values with no spaces. It puts in bartholomew.fitzgerald@northwind-industries-holdings.example.com, IMG_20250914_183022_HDR_portrait_edited_edited.HEIC, Benachrichtigungseinstellungen, a UUID and a long URL with a query string. Each wraps with overflow-wrap: anywhere or truncates in the middle. An email running out of its card is viewports-unbreakable-text.

Then call window.__stretch.run("short") for the shortest values: J, Jo and a@b.test. A layout built for long values still looks complete. A name link only as wide as J, or a card that looks broken around Jo, is viewports-shorter-text.

10. Change the script and the direction

At 375 and 1440, call window.__stretch.run("scripts"). It puts in Vietnamese Đặng Thị Ngọc Hân, Thai สมศักดิ์ ใจดี and Arabic نور الهدى عبد الرحمن. Marks above and below the letters show whole. A tight line-height with overflow: hidden cutting the marks off Đặng is viewports-tall-scripts.

When the project ships a right-to-left locale, set dir="rtl" on the root and render both widths again. The layout mirrors. Padding stuck on one side because of margin-left is viewports-mirror-rtl.

In the mirrored render, icons that point a direction flip: arrows, chevrons, back, forward, send and undo. Clocks, checkmarks, the search magnifier and media play controls stay as drawn. A back chevron still pointing left under dir="rtl" is viewports-flip-directional-icons. Fix it with :dir(rtl) .icon-directional { transform: scaleX(-1) } or the mirrored glyph.

Text the user wrote takes dir="auto", so نور الهدى عبد الرحمن inside a left-to-right page keeps its punctuation and icons on the right. In a right-to-left interface, a paragraph of three or more lines aligns to its own language, and digits never reverse. A name whose full stop jumps to its wrong end is viewports-dir-auto.

11. Report by width

Return one screenshot per width with the overlay numbers, then the findings in the same order. A finding with no width named is viewports-name-the-width.

The pair

Every check is a pair. The broken line sits beside the line that replaces it.

Rule Broken Replacement
viewports-cross-each-breakpoint Checked at 375 and 1440 only Also at 767 and 768, 1023 and 1024
viewports-no-breakpoint-gap max-width: 767px beside min-width: 768px, nothing matching at 767.5px (width < 768px) beside (width >= 768px)
viewports-render-every-width "The grid collapses at md, so mobile is fine" Screenshots at 320, 375 and 768
viewports-widest-width A 1200px column pinned left at 2560 margin-inline: auto on the column
viewports-container-width A list checked at 1440 that ships in a 280px sidebar The list rendered inside a 280px wrapper
viewports-no-sideways-scroll A width: 400px card at 320 max-width: 100% on the card
viewports-classic-scrollbar width: 100vw on a band, 15px wider than the page beside a classic scrollbar width: 100% on the band
viewports-no-clipped-text overflow: hidden cutting a label at 375 The label wraps, or truncates with a way back
viewports-no-hover-only-controls Row actions behind :hover alone Shown at all times under (hover: none)
viewports-both-orientations A "Rotate your device" overlay at 812×375 The layout reflowing to 812×375
viewports-short-heights A dialog's Save below a 375px screen max-height: 100dvh with the body scrolling
viewports-unstick-when-short A sticky header and a fixed tab bar covering 112px of a 256px screen @media (min-height: 480px) { .header { position: sticky } }, the bars static below it
viewports-text-zoom height: 32px on a button that clips at 200% min-height: 2rem with padding
viewports-text-spacing height: 32px on a tag that clips at wider spacing min-height: 32px with padding-block: 4px
viewports-longer-text width: 96px on a tab whose label doubles min-width: 96px with the label free to grow
viewports-unbreakable-text An email running out of its card overflow-wrap: anywhere on the email
viewports-shorter-text A name link only as wide as J min-width: 24px on the link
viewports-tall-scripts line-height: 1 with overflow: hidden cutting the marks off Đặng line-height: 1.5 on the line
viewports-mirror-rtl margin-left: 12px on a row's icon margin-inline-start: 12px
viewports-flip-directional-icons A back chevron pointing left under dir="rtl", or a clock flipped with it :dir(rtl) .icon-directional { transform: scaleX(-1) } on arrows and chevrons only
viewports-dir-auto <span>{name}</span> holding نور الهدى عبد الرحمن <span dir="auto">{name}</span>
viewports-name-the-width "The header overlaps" "At 768, the header overlaps the search field"

Reporting

Severity. HIGH is sideways page scroll, including the scroll a classic scrollbar exposes. It is also a control that hover alone reveals on touch, an action unreachable at a short height or a page locked to one orientation. MEDIUM is clipped text, overlap at 200% text or a break at a breakpoint edge. It is also a layout judged from the code or a sweep that skips a breakpoint edge. It is also a width no query matches, or bars that cover more than a quarter of a short screen. It is also a layout that breaks under longer text or fails to mirror. It is also a directional icon pointing the wrong way once mirrored, or a non-directional one flipped. It is also text cut by wider spacing, a value with no spaces escaping its box, marks cut off a tall script or user text in the wrong direction. It is also a component never rendered at its container width or content stranded at 2560. LOW is a finding that does not name its width, or a layout that looks broken with the shortest values.

Format. One finding per root cause, naming the width:

1. file:line - [rule-id] at 375, what is wrong (measured values)

Cite the script's element when the source line is not found. Then a Rule | Count | Severity summary. Block when any HIGH remains, Approve otherwise. Mark any width you could not render as Not verified.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warningtoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill is a professional UI/UX auditing tool designed to test web page responsiveness, accessibility, and localization readiness. It functions by rendering pages at specific breakpoints and executing local utility scripts to measure layout overflows, text clipping, and touch targets. The analysis found no evidence of malicious behavior, data exfiltration, or unauthorized code execution.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

Signed by skilld at b2e4283. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 12 hours ago.

Activeupdated yesterday

README badge

README badge for raphaelsalaja/skills/viewports