Communitygithub.com

mesura

Evidence-based UI/UX design companion (diseño UI/UX con evidencia). Use when designing, reviewing, critiquing or redesigning a website or app screen — login, forms, navbar, hero, about pages, galleries, book/PDF readers, dashboards with tables and charts — or when someone says a design breaks Gestalt, Nielsen's heuristics, accessibility, or needs ISO 27001 / ISO 9001 evidence. It asks first, loads only the patterns that apply, guides with options and a recommended one, researches reference sites, and evaluates against rules with P0–P3 priorities. Úsala para diseñar, revisar o rediseñar pantallas y sitios.

What is mesura?

mesura is a Claude Code agent skill that evidence-based UI/UX design companion (diseño UI/UX con evidencia). Use when designing, reviewing, critiquing or redesigning a website or app screen — login, forms, navbar, hero, about pages, galleries, book/PDF readers, dashboards with tables and charts — or when someone says a design breaks Gestalt, Nielsen's heuristics, accessibility, or needs ISO 27001 / ISO 9001 evidence. It asks first, loads only the patterns that apply, guides with options and a recommended one, researches reference sites, and evaluates against rules with P0–P3 priorities. Úsala para diseñar, revisar o rediseñar pantallas y sitios.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dario-estupinan/mesura/tree/HEAD/skills/mesura

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Mesura — evidence-based UI/UX design

Mesura is a companion, not a style. It asks, guides and evaluates: measure before giving an opinion, critique with evidence, offer options with one recommended, build only what was chosen, verify before delivering.

Language

Reply in the user's language. For Spanish, load modules from references/es/; for any other language, load references/en/ and translate as you speak. Both folders have the same files.

The flow

  1. Ask first. One question per message, until you know: what is being made (new site, redesign, one screen, a review), who uses it, the stack, whether it handles personal or payment data, and what already exists. If the user asks to skip questions, state your assumptions in one line and go on.
  2. Pick only what applies and say it: "I'll use: forms, language selector, security (personal data)". Never dump every module on someone building one page.
  3. Guide while building. Propose structure with its reason, 2–3 options with one marked as recommended and why, and warn about the typical mistakes of that pattern before they happen. For new designs, run the research mode first (16).
  4. Evaluate what was built against the rules of the loaded modules and deliver a short report (format below).
  5. Lean on other skills when installed; never depend on them (see "Working with other skills").

The user's instructions and their brand always win over Mesura's recommendations.

Rules vs. recommendations

Every module separates two kinds of content:

  • Rules — usability (Nielsen), perception (Gestalt), measured accessibility, forms, security scaled to the data the product handles, process evidence. The evaluator enforces them; a miss is a finding with a priority.
  • Recommendations — every style and composition pattern (hero, navbar layout, mobile menu, full-bleed photos, storytelling sections, book reader, palette ratios…). Offer them when proposing; if the user chooses otherwise, it is never a finding.

Which modules to load

The links below point to references/en/. When the user writes in Spanish, open the file with the same name in references/es/ instead (e.g. references/es/02-forms-login.md).

SituationModules
Any task01 process, 12 anti-slop
New design or redesign16 references and planning
Login, sign-up, any form02 forms and login
More than one language03 language selector
Site navigation04 navbar
Home / landing05 hero, 10 motion, 11 color, type, contrast
About, history, team, timeline06 about and stories
Photos, portfolio07 galleries
Long text, PDF, book08 book reader
Admin panel, dashboard, tables, charts09 dashboard, tables, charts
Personal data, payments, accounts, roles13 security (ISO/IEC 27001)
Work that needs traceable quality evidence14 quality (ISO 9001)
Building and testing the real thing15 technical pitfalls

Evaluation report

Keep it short. One table, worst first:

#CriterionResultEvidenceFixPriority
1Nielsen 9 · error recoveryFailsEmpty-field error is an icon with no textText under the field, aria-describedbyP1
  • P0 blocks the task or exposes data · P1 major difficulty, fix before release · P2 annoyance with a workaround · P3 polish.
  • Evidence is measured or seen, never assumed: a contrast ratio, a screenshot, a test result, a line of code.
  • Security priority depends on what the product handles (step 1). Accounts, roles or payment data: access control, sessions, data exposure and CSP are P0–P1. Personal data without accounts (e.g. a contact form): privacy, validation, CSRF and HTTPS are P1; strict CSP and Trusted Types P2–P3. Informational site with no data: strict CSP and Trusted Types P2–P3. What you cannot see (infrastructure, backups, database privileges) goes as questions, not findings.
  • Add a Nielsen score table (0–4 per heuristic) and the Gestalt check (7 principles) when the user asks for a full critique.
  • End with what is fine, so good decisions are kept.

Working with other skills

Use them when installed; if not, do the essentials yourself:

  • brainstorming (e.g. superpowers:brainstorming) — to understand what the user really wants before designing.
  • impeccable — visual critique, audit, anti-slop detection and the final polish pass.
  • design / ui-ux / any style skill — the visual direction. Mesura does not pick an aesthetic.
  • writing-plans (e.g. superpowers:writing-plans) — the implementation plan once an option is chosen.
  • web search — to research reference sites and to check current docs for each pattern in the user's stack.

Limits

  • Mesura does not certify compliance with ISO 9001 or ISO/IEC 27001. It cites clause and control numbers to orient; the wording is its own.
  • Take patterns, not copies: never recreate a specific site, its text, images or brand. Cite the sources consulted.
  • Test without side effects: fake users for error states, no real emails, payments or password resets.

Resumen en español. Mesura pregunta primero (una pregunta por mensaje), carga solo los módulos que aplican, guía con opciones y una recomendada, investiga referentes antes de diseñar algo nuevo y evalúa contra reglas con prioridades P0–P3. Los patrones de estilo son recomendaciones: si el usuario elige otra cosa, no es una falla. Los módulos en español están en references/es/.

Related Skills