From linearprincipals
Applies Linear's UI/UX and product philosophy when designing, building, or reviewing interfaces and product decisions. Use when designing UI, critiquing UX, framing a product problem, planning a redesign, deciding scope, reducing visual clutter, designing AI/agent interfaces, debating customization vs. opinionated defaults, or setting up product process. Triggers on "Linear style," "calm interface," "opinionated software," "design for craft," "reduce visual noise," "is this the right problem," "should we add a setting," "feature request vs need," "redesign strategy," "design review process."
How this skill is triggered — by the user, by Claude, or both
Slash command
/linearprincipals:linear-design-principlesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Apply how Linear thinks about UI, UX, and product. The throughline: **design is product judgment, not decoration**, and it only works when backed by structure — opinionated defaults, near-zero latency, trained quality, and small teams that own problems end to end.
Apply how Linear thinks about UI, UX, and product. The throughline: design is product judgment, not decoration, and it only works when backed by structure — opinionated defaults, near-zero latency, trained quality, and small teams that own problems end to end.
[!info] Terminology trap "Linear design" in most search results means a generic SaaS aesthetic (dark mode, gradients, minimal landing pages) named after the company. That is the look, not the method. This skill is about how Linear actually works. Ignore the aesthetic literature.
Reach for these principles when the task is one of:
references/ui-ux-craft.md.references/ui-ux-craft.md (redesign strategy).references/operating-model.md.references/sources.md.You cannot build something excellent for everyone. Pick a specific user and a specific use case and optimize hard for it; accept that it will be a poor fit outside that lane. Restraint is the strategy, not a limitation.
Ship strong defaults that guide users toward a good workflow. Flexible software lets everyone invent their own process, which becomes chaos as teams scale.
Vocabulary is a design surface. Use universal units (issues, projects, teams) so nobody needs a handbook. Don't invent terms — they mean different things to different people. Write issues, not "As a user, I want…" user stories that hide the actual need.
The most common reason design projects drag or fail is an unclear problem. Generating the form is the easy part; knowing what should exist at all is the hard part.
Dense interfaces can still feel calm if hierarchy is sharp. Don't let every element compete for attention.
"Calm, dense, fast" is not achievable with visual design alone. Linear bought the headroom for its minimal UI by making latency near zero, so the interface needs no spinners, skeletons, or progress affordances that add noise.
Craft is deliberate attention paid because it matters to the maker, not because someone is checking. It compounds through many small decisions.
Generic chat is a weak, imprecise form for most workflows. Design structured surfaces ("workbenches") where AI operates inside clear context.
Settings aren't automatically a sign of poor design. Use them for genuine preferences and repeated-use friction — not as a dumping ground for unresolved product decisions. Settings can also teach power users what's possible.
Treat requests as input, not instructions. Users describe symptoms or name a familiar solution; infer the deeper need. Don't tally feature requests blindly — research is interpretation, not transcription. (Example: users asked for "custom fields" but were really trying to track customer needs → build the purpose-built thing.)
These structural facts are why the principles above hold. Full detail in references/operating-model.md.
Copy this when designing or reviewing a feature:
Linear-style review:
- [ ] Who specifically is this for? Is it opinionated, or generically for "everyone"?
- [ ] Is the problem written clearly, in my own words? Is it the real problem or a symptom?
- [ ] Concept decided before pixels? (What is each entity, really?)
- [ ] Does every border/icon/separator earn its place? Does chrome recede?
- [ ] Tested against real/full/empty states and light/dark/custom themes?
- [ ] Any spinner that near-zero latency could remove instead?
- [ ] Is there a fast keyboard path to the primary action?
- [ ] Are we adding a setting to dodge a product decision?
- [ ] Are we honoring a request literally instead of the underlying need?
- [ ] If AI: is there a structured workbench with review/approval, not just a chatbox?
references/ui-ux-craft.md — The ten Linear blog posts worth reading (calmer interface, redesign strategy, output isn't design, design is more than code, design for the AI age, quality rituals, settings, customer needs, dashboards), each with its core lessons and link.references/operating-model.md — How Linear actually operates: org structure, decision-making, opinionated software, speed-as-architecture, the Linear Method, hiring, and planning mechanics.references/sources.md — Primary sources, interviews/profiles, technical breakdowns, and background, with sourcing caveats.Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub tylergibbs1/linearprincipals