ClaudeMap

gridlines

An agent skill for alignment passes — draws vertical guide lines down an interface, flags every item that misses its line, and fixes padding so sidebars, toolbars, panels, menus and tables share a small set of edges

Skills & Commandsskilldesign-qaalignmentfrontendaudit

gridlines mechanizes the draw-guides-first alignment pass: a probe script runs in the page and measures the ink edges of text, icons and controls; an audit script loads the page in headless Chromium, runs the probe, saves a 2x capture with the guides drawn, and writes a JSON report listing every miss with its delta (e.g. trailing 15px vs 12px, label 38px vs 36px, vertical-centre 3px vs 0px). The agent then moves items onto their lines instead of nudging pixels by eye. The probe also works without the audit script: paste probe.js into any page's console and call window.__gridlines(). Ships with an example sidebar carrying four planted misses so you can see a report before pointing it at your app, and credits its rules to Karri Saarinen's redraw of the Linear sidebar and the layout chapter of Apple's Human Interface Guidelines.

What it does

  • probe.js runs in the page and measures the ink edges of text, icons and controls, drawing the guides and listing every miss with its delta
  • audit.mjs loads a page in headless Chromium, runs the probe, saves a 2x capture with guides and a JSON report
  • Standalone probe mode: paste probe.js into any page's console and call window.__gridlines()
  • Example sidebar with four planted misses ships in the repo, so you can read a report before auditing your own app
  • Alignment rules credited to Karri Saarinen's Linear sidebar redraw and Apple's Human Interface Guidelines layout chapter

When to use it

Right tool when a rebuilt or agent-generated UI is close but slightly off — one alignment pass turns scattered padding values into a small shared set of edges across sidebars, toolbars, panels, menus and tables.

Getting started

npx skills add pritamux/gridlines

Or copy skills/gridlines/ into your agent's skills folder (for Claude Code, ~/.claude/skills/gridlines/).

/gridlines line up the settings sidebar

The audit script needs Playwright. Install it anywhere and point PW_DIR at that folder:
npm i --prefix /tmp/gridlines-pw playwright
npx --prefix /tmp/gridlines-pw playwright install chromium
PW_DIR=/tmp/gridlines-pw node skills/gridlines/audit.mjs "file://$PWD/examples/sidebar.html" .gridlines 800

Things to know

The audit script depends on Playwright and headless Chromium (install anywhere and set PW_DIR); the probe alone works in-page without any install. The skill draws vertical guide lines and flags horizontal misses against them — it is an alignment pass, not a full layout linter. Example output shows misses measured against a 240px sidebar with 12px padding; the deltas you get depend on your own edges. MIT. 46 stars as of writing (2026-11-22).

Repository

pritamux/gridlines

Charted

Related on the map

  • An instruction-only skill that makes agents research before they ask, plan before they build, and verify before they call anything done.

    • workflow
    • verification
    • quality
    • skill
  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap