Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

pritamux/gridlines

Developer Tools

An 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 →
101
1
JavaScript
MIT
new today

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

  1. react/reactA JavaScript UI library for building component-based web and native interfaces, used by frontend teams choosing a rendering stack.JavaScript251,745
  2. nolly-studio/cult-uiAn open-source library of 150+ animated shadcn/ui components for React and Next.js developers.TypeScript7,439
  3. sveltejs/svelteA compiler for declarative web components that outputs small JavaScript for targeted DOM updates.JavaScript88,514
  4. 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.JavaScript2,971
  5. figma/mcp-server-guideConnect AI coding agents to Figma files so they can generate code from designs and write back to the canvas.Python2,169