pritamux/gridlines
Developer ToolsAn agent skill that measures interface ink edges, flags misaligned items, and fixes padding during alignment passes.
This repo is an agent skill pack · 1 skillsSkill list and install →What it does
gridlines is an agent skill for UI alignment work. It infers vertical guide lines from the ink edges of text, icons and controls, then walks a sidebar, toolbar, panel, menu or table to find items whose edges miss those lines. The agent reports each miss with the expected and actual offset, and adjusts padding so the components share a small set of edges.
The repository ships three pieces: a SKILL.md describing the process and rules, a browser-side probe.js that measures edges and draws the guides, and a headless-Chromium audit.mjs that captures a 2x screenshot with guides plus a JSON report. A sample examples/sidebar.html contains four deliberately planted misses.
Quick start
Install the skill with the skills CLI:
npx skills add pritamux/gridlines
Alternatively, copy skills/gridlines/ into your agent's skills directory (for Claude Code: ~/.claude/skills/gridlines/) README install. Then ask the agent for an alignment pass, or invoke it directly:
/gridlines line up the settings sidebar
To run the audit script on your own page, install Playwright into a temporary directory and point PW_DIR at it probe instructions:
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
The last two arguments set the output directory and the viewport width. The command writes a capture and a JSON report; the report lists each miss in the form MISS y56 trailing: 15px vs 12px [12], naming the row, the measured edge and the intended line. There is also a no-script path: paste probe.js into any page's console and call window.__gridlines().
Constraints
- The audit script requires Playwright and a Chromium browser installation; the probe itself runs in the page and can be used through the console without the script.
- The rules focus on vertical edges and padding for interface chrome such as sidebars, toolbars, panels, menus and tables; they are not a general-purpose layout engine.
- The skill is distributed as agent instructions plus scripts, so the agent needs to support skill installation or a manual copy into its skills folder.
- The alignment rules are credited to Karri Saarinen's Linear sidebar redraw notes and the layout chapter of Apple's Human Interface Guidelines README; the project is MIT licensed.
HotRepo's take
The project appeared in the JavaScript new-repository list on 2026-11-22 with 100 stars gained in roughly a 15-hour window, going from creation to the recorded snapshot. That is a single snapshot, so it establishes initial attention rather than a trend. The delivered content is a compact, reusable skill with a probe and a headless audit path plus a reproducible example, which makes the alignment rules checkable rather than purely advisory.
Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.
You might also like
- react/reactA JavaScript UI library for building component-based web and native interfaces, used by frontend teams choosing a rendering stack.
- nolly-studio/cult-uiAn open-source library of 150+ animated shadcn/ui components for React and Next.js developers.
- sveltejs/svelteA compiler for declarative web components that outputs small JavaScript for targeted DOM updates.
- plugin87/ux-ui-agent-skillsGives coding agents a design-system doctrine and 52 machine-checkable gates, so generated UI fails the build instead of shipping as slop.
- figma/mcp-server-guideConnect AI coding agents to Figma files so they can generate code from designs and write back to the canvas.