interface-architecture

A guide to deciding the basic structure of an interface before choosing its detailed visual style, including navigation, information structure, layout, and interaction rules.

In plain words
What is it for?
It helps choose layouts for websites and apps, define navigation, separate structural decisions from visual polish, and establish a consistent set of type, colors, spacing, icons, and depth.
Why use it?
It helps prevent a visually polished interface from having confusing navigation or a poor way of organizing information.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/lenxism/ives/interface-architecture
Any agent
npx skills add lenxism/ives --skill interface-architecture
Clone the repo
git clone --depth 1 https://github.com/lenxism/ives

Made for: Claude Code, Codex.

Per session 105 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,233 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00105 $0.01233
Opus 5 $0.00053 $0.00616
Sonnet 5 $0.00021 $0.00247
Haiku 4.5 $0.00011 $0.00123

Measured 2d ago against content hash 9e97a09c9e8f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

interface-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/interface-architecture/SKILL.md · 138 lines

How it starts

The opening of the file, as written. The whole thing — 138 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Interface Architecture

Getting architecture right means the interface feels intuitive even before it looks beautiful. Getting it wrong means no amount of polish saves it.

Start with Defaults

Ask: "What would default iOS give us?" or "What would shadcn + Tailwind look like?"

This establishes the most conventional, familiar solution — then you optimize.

iOS defaults: Tab bars for peer destinations, table views for lists, push navigation for drill-down, sheets for focused tasks.

Web defaults: Sidebar navigation for apps, top nav for marketing, card grids for browsable content, modals for focused tasks.

The best products — Family, Raycast, Linear — show deep respect for platform conventions while innovating on every aspect. Understand the standard, match it, then exceed it.

Separation of Concerns

Before diving in, identify what question you're answering, then go only as far as needed:

  • Architecture: Right interaction model? (Don't need visual design yet)
  • Layout: Information structure make sense? (Don't need final content)
  • Visual Language: Colors, type, spacing convey right attributes? (Test on isolated components)
  • Polish: Details refined? (Only after everything above is resolved)

Working on everything at once leads to rabbit holes and compounding rework. Slow is smooth, smooth is fast.

Fidelity decisions

  • Testing interaction model: White cards with shadows, no content. Just the interaction.
  • Exploring architecture: Simple boxes and labels. Just the structure.
  • Refining visual language: Component playground. Just the aesthetic.
  • Shipping: Full fidelity. Everything considered.

Information Architecture

Reduce cognitive load through grouping

A flat list of 40+ items overwhelms. Group into phases, categories, or sections. Natural chunking makes the whole feel manageable.

Progressive disclosure

  • Root level: Show phases/categories, not all items
  • Drill-down: Items within the selected group
  • Detail: Full information for the selected item

Read the full file on GitHub · 138 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 138 lines · 105 tokens per session scan A 9e97a09c9e8f

Subscribe to this mod's changes

interface-architecture is a skill published in the GitHub repository lenxism/ives (5 stars, last pushed 6mo ago), licensed MIT. It adds 105 tokens to every session and 1,233 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.