agentsclimarketplace

Wireframe elements

Skill jpoindexter/wireframe-skills/skills/wireframe-elements

The complete wireframing discipline as agent skills — /wireframe dispatcher + 7 reference skills distilled from Wireframing for Everyone (A Book Apart)

Install
npx -y skills add jpoindexter/wireframe-skills --skill wireframe-elements

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when choosing which UI component represents a need in a wireframe, tempted to invent a custom control where a standard one exists, unsure what belongs on a screen type (dashboard, list, detail, form, settings), deciding between list, table, tiles, or cards, picking horizontal vs vertical navigation, representing components at low fidelity, or consolidating repeated screens into page templates.

SKILL.md

15.1 KB, as published. Nobody here has run it

Wireframe Elements — Components, Patterns, Templates

Overview

Every box in a wireframe stands for something with a name. Users arrive trained by every other product they use (Jakob's Law), so the fastest wireframe is assembled from the standard vocabulary: components (the atoms — text, buttons, selectors) combine into patterns (navigation, content, input groups that solve one problem) which combine into page templates (screen archetypes reused across the product). Wireframing is choosing the right existing element, not drawing a new one.

When to Use

  • Turning rough idea-sketches into named interface objects
  • Deciding what a shape in a wireframe is — button, link, dropdown, card
  • Choosing the content pattern (list vs table vs tiles vs cards) or navigation orientation for a screen
  • Blocking out a standard screen type: home, list/browse, detail, form, dashboard, settings
  • NOT for: visual design — color, type, spacing polish (layout-and-composition)
  • NOT for: deciding which screens the product needs at all (userflow)
  • NOT for: deep per-pattern mechanics — validation timing, sort behavior (flow-forms, flow-tables)

UI Anatomy

A screen is regions before it is components. Block these out first; each region hosts specific pattern types:

RegionHostsNotes
Header / app barLogo, primary nav, search, account entryPersistent across screens; every pixel here competes with content
Content areaThe screen's one job: content + input patternsThe part the user came for — give it the most space
SidebarSecondary nav or filtersLeft in LTR cultures; always visually below/inside primary nav's hierarchy
FooterMega-menu-style nav + legal, contactNavigation of last resort — anything users must find also goes near the top
Overlay layerModals, prompts, cart previews, flyout menusInterrupts everything below; earn its use

Component Vocabulary

The heart of the skill: need → standard component → how to draw it at low fidelity. Rule of thumb for text: real words for anything the user acts on (headings, buttons, nav items, option labels — these ARE design decisions); lorem/squiggle lines only for body copy whose content you don't control.

NeedStandard componentLow-fi representation
Tell users where they arePage title / headingLargest text on screen, top; real words; exactly one per page
Explain or narrateBody textHorizontal squiggle/lorem lines broken by real subheads — never one solid block
Say what an input wantsLabelReal short noun above the field; never placed inside the field
Suggest valid inputHelper textGray example inside or below field ("e.g. [email protected]")
Explain on demandTooltipSmall ? circle; draw the bubble only if its content matters to the review
The one desired actionPrimary buttonFilled rectangle, real verb label ("Pay", "Reply" — never "Submit" or lorem); one per screen
Alternative actionSecondary buttonOutlined (unfilled) rectangle beside/below the primary
Low-priority actionText buttonPlain text placed like a button, no box (e.g. "Undo" in a toast)
Navigate awayLinkUnderlined text; link the key words only, never a whole sentence
Pick exactly one of 2–5Radio groupVertical stack of ○ + real option labels; show the default filled ●
Pick many or noneCheckboxesVertical stack of ☐ + real option labels
Pick one from a long listDropdownRectangle with caret ▾, default value shown inside; use when options > 3–5 or space is tight
Discover by topic/categoryTagsSmall pill outlines containing real category words
Enter short free textText inputEmpty rectangle, label above, width matching expected answer length
Enter long free textText areaTaller rectangle, label above
Find anythingSearch barOutlined field + magnifying-glass icon + the word "Search"; top of screen
Show a pictureImage placeholderBox with an X corner-to-corner; annotate subject if it matters
Show a symbolIcon placeholderSmall square or circle; label its meaning when it's load-bearing

Defaults: every selector gets a sensible pre-selection when one exists — most common, or last-used. Base the default on the user's likely intent, never on what benefits you (pre-selecting expensive shipping is manipulation, not design).

Buttons vs links: buttons perform actions, links go places; the web has blurred this — pick a convention and hold it consistently across the product.

Patterns

A pattern is a reusable group of components that fulfills one function — components alone do nothing (a text box needs its Send button). Three families cover most screens:

Navigation patterns

Choose only after you know the rough breadth and depth of the sitemap:

  • Horizontal bar — a handful of top-level items. Prominent and persistent, so every extra item taxes attention. Mobile: ≤4 items for tap targets; overflow into scroll or a "More" menu, reluctantly.
  • Vertical sidebar — many or unknown items, or hierarchy. Scrolls naturally; shows nested levels as flyout overlays, accordions, or a fully expanded tree.
  • Secondary nav — local (items within the selected section) and contextual (changes per section). Two shallow levels → a second horizontal row with both levels' selection visible; deeper/wider → dropdown or mega-menu, or a sidebar rendered below the primary bar so it can't be mistaken for it.
  • Breadcrumbs — text links separated by arrows; current page is the last item, plain text, never linked; always repeat the page name as the heading below — breadcrumbs are too small to be the only "you are here."
  • Footer nav — full-width mega-menu plus legal/contact. Last resort: users go there when they've failed everywhere else.

Navigation's job is signposts, not teleportation — like highway signs, list the main destinations, not every exit.

Content patterns

Let the content dictate the pattern, not the reverse. All of these depend on items being similar in size — long prose forced into any of them breaks scanning.

PatternUse whenLow-fi
ListLarge/unknown count of brief, similar items (files, emails); optional per-row icons/actionsStacked single-line rows, small leading icon squares
TableMulti-dimensional data; per-row actions (edit, delete, export)Grid with a bolded header row; show only columns users act on
TilesImagery alone identifies each item (media browsing); scrolls in one dimensionRow of X-boxes, edge one cut off to signal scroll
CardsImage + title + description + actions; wraps as a gridBox: X-box top, one bold title line, 1–2 squiggle lines, optional button

For tables: decide the most important columns first, push the rest to the detail page, and optimize around what the user does with the data, not what you could display.

Input patterns

  • Forms — the components combined: labels + inputs + selectors + one primary button. Ask only what you absolutely need; split long forms into logical steps; single column; labels above (or left, for long forms) — never inside the field; double the whitespace you think you need. Depth: flow-forms.
  • Modals / prompts — interrupt to ask a question or force a decision. Plain language, conventional button placement, default = the least destructive action. Users resent them; use only when the task truly blocks continuing.
  • Search bar — omnipresent, top of screen, boringly standard in appearance; helper text and autocomplete/predictive suggestions earn trust. Depth: flow-search.
  • Filters — selection components that narrow results. Group options by type (Price, Brand, Rating); always show which filters are applied; always offer clear-all. Few filters → horizontal above results; many → vertical panel beside results.

Page Templates

Templates are pattern collections representing screen archetypes. Even thousand-page sites run on fewer than ten. Wireframe templates last — let them emerge from repeated pattern combinations, then consolidate lookalike screens into one template. Contents below in priority order (top of screen first):

TemplateContents, in priority order
Home / landingIdentity + value proposition → primary nav + search → featured entry-point content → footer
List / browse / categoryPage title → filters + sort → one content pattern (list/table/tiles/cards) → pagination or load-more. Reuse this same template for search results
DetailBreadcrumbs → title → primary media or data → primary action (buy, edit, share) → supporting detail sections → related items
Form / create-editTitle naming the task → single-column fields grouped by topic → primary + secondary buttons at the end
DashboardTitle + scope (date range) → key metrics as cards → charts/tables → recent-activity list. Most-glanced information first
SettingsVertical section nav → one topic per pane → grouped controls, saved immediately or via one explicit button

Required Context

  • The content each region must hold — component choice follows content, never the reverse.
  • Breadth and depth of the sitemap — this decides the navigation pattern, and nothing else should.
  • Platform conventions in play (web, iOS, Android, desktop).
  • The existing design system, if one constrains the component vocabulary.
  • Which states exist — empty, loading, error, partial, over-long — before choosing a control.

Evaluation Procedure

  1. For each region, state the content and the job before naming a component.
  2. Choose navigation only after breadth and depth are known: broad → vertical, few items → horizontal.
  3. Check every component against a known pattern before inventing one.
  4. Render each element with its longest realistic content, and with none.
  5. Confirm real text on buttons, nav items, headings, and labels; lorem only in body copy.
  6. Check that what's clickable reads as clickable at grayscale fidelity.
  7. Confirm every interactive element has its states accounted for, even if unstyled.

Output Format

Region: <name> — content: <what it holds> — component: <choice> — because <job>
Navigation: <pattern> — from breadth <n> × depth <n>
Patterns reused: <named patterns>  ·  Invented: <any, with justification>
States covered: empty / loading / error / long-content
Real text where required: <yes | list of remaining lorem>

Quick Reference

DecisionRule
Nav: many/unknown items or hierarchyVertical sidebar
Nav: a handful of flat itemsHorizontal bar
Mobile nav bar≤4 items; overflow to "More"/hamburger
Two shallow nav levelsSecond horizontal row, both selections highlighted
Deep or wide sub-navDropdown/mega-menu, or sidebar below the primary bar
Brief similar items, unknown countList
Multi-column data + row actionsTable
Image is the identifierTiles
Image + text + actions in a gridCards
One-of choice, ≤5 optionsRadio group
Many-of choiceCheckboxes
One-of choice, long list or tight spaceDropdown with a default shown
Selector defaultMost common or last-used, in the user's interest
Interrupting questionModal; default button = least destructive
Few filter groupsHorizontal, above results
Many filter groupsVertical panel beside results
Search placementTop, omnipresent, standard field + icon
Button/nav/heading text in a wireframeReal words, always
Body copy in a wireframeSquiggles or lorem is fine
Template count for whole productFewest possible; consolidate lookalike screens

Anti-Patterns

MistakeFix
Inventing a custom control where a standard existsUse the convention — Jakob's Law means novel controls tax every user
Unlabeled buttons or input fieldsEvery actionable element gets real text, even at lowest fidelity
Lorem ipsum on buttons, nav items, headingsReal labels — the words are the design decision being tested
Label placed inside the input fieldLabel above the field; helper text inside is for examples only
Two primary buttons on one screenOne filled primary; demote the rest to secondary/text buttons
Linking a whole sentenceLink only the meaningful words
Dropdown for 2–3 optionsRadio group — don't hide options that fit on screen
No default selection in a selectorPre-select the most common or last-used choice
Default chosen for the business, not the userDefault to the user's likely intent (never the priciest option)
Picking a nav pattern before knowing the sitemapSketch breadth/depth first; the structure chooses the pattern
Secondary nav rendered above/level with primaryPlace it below primary so hierarchy reads correctly
Breadcrumbs as the only location indicatorRepeat the page name as the heading; last crumb plain text
Key content reachable only via footerFooter is last resort — duplicate the path near the top
Long prose forced into lists or cardsSimilar-sized brief items only; prose gets a body-text page
Text overlaid on images without contrastAdd a scrim, or move the text off the image
Modal for anything non-blockingInline the message; modals only when continuing requires an answer
Destructive action as the modal defaultDefault = least destructive; make deletion the deliberate click
A unique layout for every screenConsolidate into <10 templates; repetition is what users learn
Wireframing templates firstPatterns first; templates emerge from repeated combinations

Companion Skills

SituationCo-fire
Deciding which screens/flows the product needsuserflow
Component interaction states (hover, disabled, error)components-and-states
Form fields, validation, wizard steps in depthflow-forms
Table sorting, filtering, bulk actions in depthflow-tables
Search behavior, results, zero-result handlingflow-search
Nav architecture, menu depth, IA restructuringflow-navigation
Overall shell: sidebar+main, panes, responsive collapseflow-app-shell
Screens before data arrives (empty, loading, error)flow-empty-states
Arranging patterns on the page, hierarchy, whitespacelayout-and-composition
Icon placeholders becoming a real icon systemiconography-and-imagery
Replacing placeholder labels with real copyux-writing-and-content
Formalizing component→pattern→template into a systemdesign-tokens, components-and-states

Distilled from Wireframing for Everyone (Michael Angeles, Leon Barnard, Billy Carlson — A Book Apart, 2023), extended with production practice.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.