Mindket

Interfaces: agent skills for building UI

Newversion 2 · updated
Star11.5k

Overview

Jakub Krehel’s collection of agent skills for interface work: they review and fix accessibility, layout, typography, color, UI polish and interface copy, and add commands that review a pull request or stress test a component.

Interfaces: agent skills for building UI is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 2, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

Runs in
  • Claude Code: the interfaces plugin from the maker’s marketplace
  • OpenCode: the skills CLI and its opencode target, which the maker points to
  • Codex, Cursor and others: the skills CLI installs into the agents it finds on your computer
  • Figma: build-design reads a Figma link through a Figma MCP server you connect
Start with
/plugin marketplace add jakubkrehel/skills
/plugin install interfaces@interfaces

Platform

Claude CodeCoding agent
OpenCodeCoding agent
CodexCoding agent
CursorCode editor

About

What it is

Interfaces is Jakub Krehel’s set of 14 agent skills for building and reviewing user interfaces. Six better-* skills each own one field: typography, color, accessibility, layout, interface copy and UI polish. A seventh, better-interface, runs them over a screen and merges what they find into one ranked report. The topics are the ones he writes about on his own site and in his design engineering magazine, also called Interfaces.

  1. You ask for a review of a screen or a change
  2. better-interface hands it to each better-* skill
  3. Each skill checks its own field and keeps the evidence
  4. One table, ranked by what each problem costs the user
  5. A verdict: Block or Approve

Who it suits

Front-end developers and design engineers who care how an interface reads and behaves, from type and spacing to copy and keyboard focus. It also suits teams with a design system they want an agent to respect, since build-design works from the project’s own tokens and components.

Who uses it, and how
IndustryWho uses itHow they use itExample
Software and SaaS productsDesign engineersReview a new flow for copy, contrast and focus before it reaches QAA design engineer reviews a new onboarding flow and fixes the HIGH rows before handing it on.
Open source and shared codebasesMaintainersRun interface-review on each pull request that touches the UIA maintainer sees which problems a pull request brought in, kept apart from the ones that were already there.
Agencies and studios that hand off in FigmaFront-end developersTurn a Figma frame into code with build-design and the project’s own componentsA developer with a Figma MCP server connected builds a settings panel from a frame, using the design system’s tokens.
Teams with a component libraryUI engineersRender a component in every scenario or state on a throwaway pageA team renders a form component under every scenario that can reach it with break, then deletes the temporary page.
Design education and researchDevelopers studying other sitesAsk explain-interface how a live page or effect was builtA developer asks how a page they admire builds its animation.

Back-end work gives it nothing to review.

Where to use it

The README covers two routes, and two skills reach outside your editor.

  • Claude Code: the interfaces plugin from the maker’s marketplace
  • OpenCode: the skills CLI and its opencode target, which the maker points to
  • Codex, Cursor and others: the skills CLI installs into the agents it finds on your computer
  • Figma: build-design reads a Figma link through a Figma MCP server you connect
  • Live pages: explain-interface fetches them or reads them through a scriptable browser such as chrome-devtools-mcp
What you can point it at
TargetWhat comes back
A screen, a flow or a whole interfaceOne ranked report from better-interface
A branch, a pull request or an uncommitted changeinterface-review’s findings, each marked by where it came from
A Figma file or a design imageUI built with the project’s own tokens and components
A live URL or a screenshotHow the site or the visual effect was built
One componentIts scenarios or states on a throwaway page, or several versions to pick from

How to set it up

Get it saves a zip of Mindket’s setup notes in your downloads folder. The skills themselves install from Jakub Krehel’s repository, as a plugin in Claude Code or through the skills CLI anywhere else.

What you need first
NeedDetail
A coding agentClaude Code for the plugin, or an agent the skills CLI supports, such as OpenCode, Codex or Cursor
Node 22.20 or newerOnly for the skills CLI, Vercel Labs’ npm package skills, not Jakub Krehel’s
A Figma MCP serverOnly for build-design with Figma links. Without one, it asks you to connect it
A scriptable browserOptional, for explain-interface on a live page
  1. Unzip the kit and open setup/claude-code.md or setup/other-agents.md.
  2. In a Claude Code session, run the two plugin lines below, in order.
  3. In any other agent, run the npx line in the project folder that should get the skills.
  4. Pick the agents that get them when the CLI asks.
/plugin marketplace add jakubkrehel/skills
/plugin install interfaces@interfaces
npx skills add jakubkrehel/skills

Plugin updates reach Claude Code only when the maker raises the plugin’s version, which he does with every skill change.

How to use it

Most skills load by themselves when a request matches, such as a request to fix contrast or tighten a heading.

Skills that load on their own
SkillWhat it does
better-interfaceRuns the other better-* skills over a screen, a flow or a whole interface and returns one ranked report
better-uiSurfaces, icons and motion, with exact values for radius, shadows and animation
better-typographyType scale, spacing, font features, wrapping, truncation and punctuation
better-colorsPalettes, semantic token names, color format conversion and contrast checks
better-accessibilityKeyboard and focus, ARIA, forms and motion, checked against WCAG 2.2
better-layoutGrouping, alignment, reading order and responsive structure
better-writingLabels, errors, empty states, confirmations and the rest of the interface copy
build-designBuilds UI from a Figma file or a design image with the project’s own tokens and components
teardownMakes a technical illustration you can configure and export as SVG, PNG or PDF

Five run only when you call them.

Skills you call yourself
SkillWhat it does
interface-reviewReviews a branch, a pull request or an uncommitted change
explain-interfaceExplains how a site or a visual effect was built, from a live URL or a screenshot
breakRenders one component under every scenario that can reach it
state-machineRenders every state of a component on a throwaway page with mock data
variantBuilds several versions of a component so you can pick one

In Claude Code that is a slash command, and everything after it is the target. This one reviews pull request 482:

/interface-review pr 482

Example

You finish a new checkout screen and ask your agent for a review.

Review the checkout screen for accessibility, layout and copy problems.

One table of at most 15 findings comes back, ranked HIGH, MEDIUM or LOW by what each does to the person using the screen. A row gives the file and line, the problem, the fix and the evidence. One root cause is one row, with every place it shows up. The verdict is Block while a HIGH finding remains, else Approve, and your code stays as it was until you ask for fixes.

For newcomers and experts

If you are new. Small details decide whether an interface feels finished. Text you can read and buttons that say what they do are most of it. These skills give your agent rules for each field and one review that ranks what to fix first. Ask for a review of one screen you built, then fix only the HIGH rows.

For experts. better-interface ranks findings by severity, then by how far one fix reaches, so a token or shared-component fix outranks the same symptom in one leaf. Some findings are HIGH on sight, such as a control with no accessible name. The cap of 15 keeps reviews short and can hide lower-ranked issues on a big screen. Blockers are never the ones it cuts.

How interface-review marks a finding
MarkMeaningCounts toward the verdict
IntroducedThe change under review brought it inYes
RegressionThe change broke something that workedYes
Pre-existingIt was there before the changeNo

Good to know

Some skills write to your project while they work, and each cleans up on your word.

  • Your code: your agent’s model reads it as it works
  • interface-review: read-only, it fetches pull request refs and never checks them out over your files
  • break and state-machine: they add a throwaway route with mock data and remove it only when you say you are done
  • variant: it puts its versions on the real page until you pick one, then deletes the rest
  • teardown: it copies helper scripts into tools/teardown/ in your project and runs them with Node
  • Usage data: the skills CLI sends anonymous usage data unless you set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1
  • License: MIT

README and files

README
# Interfaces: agent skills for building UI

This kit holds setup notes written by Mindket, nothing more. The skills and the Claude Code plugin themselves install from Jakub Krehel's repository https://github.com/jakubkrehel/skills. No skill file from that repository is copied here.

License: MIT, per the repository's LICENSE file (https://github.com/jakubkrehel/skills/blob/HEAD/LICENSE).

## Files in this kit

- setup/claude-code.md: the plugin install for Claude Code.
- setup/other-agents.md: the skills CLI line, which the maker also points OpenCode users to.

## What installs

One plugin named interfaces, served from a marketplace also named interfaces (source: .claude-plugin/plugin.json and .claude-plugin/marketplace.json in the repository). The README lists these skills:

- better-interface: runs the other better-* skills on a screen, flow or whole interface and returns one ranked report.
- better-ui: surfaces, icons and motion, with exact values for radius, shadows and animation.
- better-typography: type scale, spacing, font features, wrapping, truncation and punctuation.
- better-colors: palettes, semantic token names, color format conversion and contrast checks.
- better-accessibility: keyboard and focus, ARIA, forms and motion, checked against WCAG 2.2.
- better-layout: grouping, alignment, reading order and responsive structure.
- better-writing: interface copy such as labels, errors, empty states and confirmations.
- build-design: builds UI from a Figma file or design image with the project's own tokens and components.
- teardown: a technical illustration you can configure and export as SVG, PNG or PDF.
- interface-review: reviews a branch, pull request or uncommitted change. You call it yourself.
- explain-interface: explains how a site or visual effect was built, from a live URL or screenshot. You call it yourself.
- break: renders one component under every scenario that can reach it. You call it yourself.
- state-machine: renders every state of a component on a throwaway page with mock data. You call it yourself.
- variant: builds several versions of a component so you can pick one. You call it yourself.

Source: README at https://github.com/jakubkrehel/skills

## Updating and removing

- Claude Code: the maker's AGENTS.md says plugin updates look only at the version field in plugin.json, and the maker raises it with every skill change. Details in setup/claude-code.md.
- skills CLI: its own update and remove commands are in setup/other-agents.md.
- The maker's README gives no removal steps.

## What runs on your machine

- teardown copies its assets and scripts folders into tools/teardown/ in your project and runs its scripts with Node; its preview page build needs packages installed with your package manager (skills/teardown/SKILL.md, verification.md and viewer-assets.md).
- break and state-machine add a scratch route with mock data to your app and delete it only when you say you are done (each skill's SKILL.md).
- variant puts its versions and a picker on the page that will hold the component. Once you pick one, it deletes the others, the picker and that page's import of them (skills/variant/SKILL.md).
- interface-review runs read-only git commands, plus git fetch for pull request refs, and does not edit your checkout. To render a target that is not checked out, it uses a temporary git worktree (skills/interface-review/SKILL.md).
- build-design needs a Figma MCP server for Figma links; explain-interface can read live pages directly or through a scriptable browser.
Files
README.md  3 KB
setup/claude-code.md  2 KB
setup/other-agents.md  2 KB

3 files, 7 KB, downloaded as a zip.

What’s new

  • Version 2 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • Version 1 · 2026-11-03

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

sixtyjHallmark – Anti-AI-Slop Design Skill for Claude Code, Cursor, and CodexI have tried all possible ways: skills, shuffle.dev ai editor, moonchild.ai, giving screenshots of existing sites as a sample. I don’t count Lovable or Figma html2figma plugin or figma2code plugin etc. After burning a lot of time and endless tinkering, I have realized that the only way to speed up…Aditya Mitrahttps://www.skills.sh/emilkowalski/skills/emil-design-eng https://www.skills.sh/jakubkrehel/skills/better-ui Someone made this CRM with these 2 skills I use a different variant of these #design #frontend #aitools8 likescocoflunchyLaunch HN: Bloomy (YC S26) – AI-powered mastery learning for K-12I think 383toast is talking about your landing page design which has very strong AI-generated design vibes (blue-green gradients, rounded rectangles with a colored border on the left...) There are a bunch of skills you can find online to improve on this if you want to keep designing with Claude,…@hydromo.bsky.socialGitHub weekly trending Top 10 (Oct 31) 1 hallmark · 2 security-audit-skill · 3 claude-seo · 4 impeccable · 5 superpowers · 6 andrej-karpathy-skills · 7 TradingAgents · 8 jakubkrehel/skills · 9 taste-skill · 10 t3code Use cases and links are on the cards. https://github.com/trending?since=weekly1 like · 2 repliesAli MabsouteFour of this week's 16 GitHub trending repos are design skills for coding agents (impeccable, hallmark, taste-skill, jakubkrehel/skills), 26,343 new stars between them. t3code led the page at +14,580. Have you given your agent any design rules yet?1 like · 1 reply@hydromo.bsky.social이번 주(10/31 기준) GitHub 트렌딩 TOP10 1 hallmark · 2 security-audit-skill · 3 claude-seo · 4 impeccable · 5 superpowers · 6 andrej-karpathy-skills · 7 TradingAgents(투자 조언 아님) · 8 jakubkrehel/skills · 9 taste-skill · 10 t3code 활용 한 줄과 링크 10개는 카드에 정리했습니다. https://github.com/trending?since=weekly1 like · 1 replyAlexIf your app looks cheap, it's not your stack. It's your motion and polish. These 2 skills are mandatory: https://emilkowal.ski/skill - animation, curves, Apple-level fluidity https://www.skills.sh/jakubkrehel/skills/better-ui - radius, optical alignment, the tiny details that compound@ai-linkstream.bsky.socialDiscover insights in AI development from Jakub Krehel's Skills repository, featuring reviews on interface design. Check out documents like SKILL.md and scope-resolution.md for understanding AI capabilities. https://github.com/jakubkrehel/skills/tree/main/skills/interface-reviewTom Dörrhttps://github.com/jakubkrehel/skills@mat-logi.bsky.social[개발] 디자인 감각을 스킬로 쪼개 담았다는 밤 피드에 레포 하나 걸렸다. 에이전트한테 붙이는 스킬 묶음인데, 애니메이션·타이포·레이아웃·컬러처럼 프로덕트 디자인을 조각조각 나눠서 각각 스킬로 만들어놨더라. 아직 안 써봤는데, "예쁘게 해줘" 대신 "타이포 스킬 켜" 식으로 결을 집어주는 접근이라 각이 좋아 보인다. 외주 데모 화면 급조할 때 디자인 감 없는 사람 보조바퀴로 괜찮을 듯. 별은 꽤 받았다더라. https://github.com/jakubkrehel/skills 스킬 이렇게 쪼개는 방식, 너넨 어떻게 봄? #개발…

Searched

More from Mindket

See all from Mindket

anaksor-ocr

Sokheng · Kit

Reads Khmer and English text from documents, receipts and photos of signs, using a detector for text lines and a recogniser for each line. Suits developers who…

New

Qwen2.5-7B-Instruct as GGUF files in eight quantization sizes, to chat with locally through llama.cpp. For people who want a capable 7.6B model on their own co…

New

ACE-Step 1.5 XL SFT

ACE-Step · Kit

Generates music from text with a 4B diffusion decoder, 50 steps and guidance control, aiming for higher audio quality than the base. For creators with a GPU of…

New

Similar in Developer

See all in Developer

Claude Code Skills & Plugins

alirezarezvani · Skill

Adds 411 ready-made skills for Claude Code and other coding agents, grouped by role from engineering and product to marketing, finance and compliance. Installs…

New29.8k

buzz

block · Kit

Self-hostable workspace where people and AI agents share the same rooms, built on a Nostr relay that logs every action as a signed event. For teams that want t…

New37.3k

plannotator

backnotprop · Kit

Opens your AI coding agent's plans, specs and code changes in a browser so you can annotate or comment on them and send the feedback straight back to the agent.

New10.5k