Wireframe fundamentals
Skill jpoindexter/wireframe-skills/skills/wireframe-fundamentals
The complete wireframing discipline as agent skills — /wireframe dispatcher + 7 reference skills distilled from Wireframing for Everyone (A Book Apart)
npx -y skills add jpoindexter/wireframe-skills --skill wireframe-fundamentalsAssembled 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 deciding whether to wireframe or jump straight to high-fidelity design or code, choosing the right fidelity for a design artifact, or picking a wireframing tool or method. Also fires when stakeholders skip ideation and commit to the first concept, demand 'just make it look real,' polish visuals during early exploration, sign off on branding instead of structure, or when a project derails after coding starts because flaws weren't caught on paper.
SKILL.md
14.9 KB, as published. Nobody here has run it
Wireframe Fundamentals
Overview
Fidelity should correspond to certainty: never render more polish than you have validated decisions to back. A wireframe's output is shared understanding, not the artifact — it is a sketch/prototype hybrid built to be cheap to make, cheap to change, and cheap to discard, so structural flaws surface before anyone writes code.
When to Use
- Starting any new screen, feature, or product — before visual design, before code
- Choosing the fidelity of the next design artifact, or deciding whether to move up or down a level
- Picking a wireframing method or tool (paper, whiteboard, dedicated software)
- Unblocking a team stuck debating pixels because it jumped straight to polished mocks
- Aligning developers and stakeholders on structure and flow before build starts
- NOT for: visual polish — type, color, brand, motion. That's comp/mockup territory (co-fire hallmark)
- NOT for: validating fine interaction detail with users — that needs a prototype, not a wireframe
Why Low Fidelity Wins
- Polish manufactures false confidence. A realistic-looking design reads as "nearly done" to every reviewer: feedback shifts from structure to branding, and sign-off happens on the wrong axis. Teams that go spec → polished prototype routinely scrap months of work that three rounds of throwaway wireframes would have caught. The deliberately hand-drawn look of wireframe tools exists to prevent exactly this misread.
- Omission is the feature. Leave detail out on purpose so attention lands on structure, content, and flow. A wireframe that can't be mistaken for the product invites structural critique; one that can, invites font opinions.
- Cheap-to-change beats cheap-to-make. Paper sketches are fast to make but slow to revise; prototypes are slow at both. Digital wireframes are the only artifact fast at both — which is what makes them usable across divergence and convergence.
- The image in your head is fuzzier than you think. Externalizing an idea exposes the gaps — forgotten states, missing steps, unhandled cases — that stay invisible while the idea lives only in your head. If the first wireframe reveals nothing missing, you copied instead of thought.
- Volume is the method, not waste. At Pixar, a single ninety-minute reel takes about twelve thousand storyboard drawings, and up to ten reels are made per film — up to 120,000 drawings before animation begins (Ed Catmull, who calls failure "a manifestation of learning and exploration"). René Redzepi of Noma puts the ratio plainly: for every amazing idea that comes out, you need ten ideas to come in. If you expect to ship your first concept, treat that as a red flag, not efficiency.
The Fidelity Ladder
| Level | Looks like | Certainty it encodes | Use it for |
|---|---|---|---|
| No-fi | Boxes, arrows, flowcharts, content lists — no UI elements | Problem and flow still unknown | Discovery: mapping options, screens, content models |
| Low-fi | Rough single-color frames, imprecise lines, placeholder text | Candidate structures forming | Rapid divergence: many layout concepts in minutes each |
| Mid-fi | Real UI components, real headings/labels/CTAs, limited palette, lorem body copy | Structure agreed; interaction being refined | Combine-and-refine, layout/component variants, early feedback |
| Late-phase | Mid-fi + annotations, arrows between screens, complete flows, sample content | Structure and flow settled | Stakeholder review, developer handoff — must stand alone |
| Hi-fi | Indistinguishable from product, may be interactive | Visual + interaction decisions locked | It's a prototype/comp now, not a wireframe — different artifact, different rules |
Move up one level only when the questions the current level exists to answer are answered: flow validated before layout detail, layout agreed before component choice, structure signed off before any realism.
Move down a level when any of these fire:
- Reviewers comment on colors, fonts, or spacing instead of structure — the artifact is over-rendered for the decision at hand
- Debate is about missing features or flow order, not the screen in front of you
- A concept dead-ends, or new requirements land — restart cheap, don't renovate expensive
- You catch yourself nudging pixels before the flow is agreed
If a stakeholder asks for a "high-fidelity wireframe": that's a request for a comp or prototype. Build that as a separate artifact — don't inflate the wireframe, or you lose its license to change.
Wireframes Across the Process
Volume expands during divergence, contracts during convergence — and fidelity rises only as decisions lock. Convergence is not one smooth funnel: alternate small converge/diverge steps (Pugh's controlled convergence), letting new variants emerge from evaluating survivors.
| Phase | Fidelity | Wireframe count | Exit criterion |
|---|---|---|---|
| Discovery | No-fi | Many fragments | Screens, flows, and content are enumerated; options mapped |
| Definition | Low-fi | ≥3 distinct concepts | Team can argue structure without arguing visuals |
| Design | Mid-fi | 1–2 merged survivors + variants | One structure agreed; interactions and navigation resolved |
| Build/handoff | Late-phase | Complete annotated flow | A developer can build from it with the author absent |
- Discovery — no-fi. Goal: get ideas out of your head and use what emerges to generate more. Flowcharts, screen-connection diagrams, content placeholders. Move fast with whatever tool is fastest; more starting ideas is strictly better. If you're adding UI detail here, you're spending too long on one idea — step back.
- Definition — low-fi. Generate ≥3 structurally distinct concepts per problem before converging on any. Judge a concept by the conversation it creates, not its craft. Kill the unconscious rule that design artifacts must look finished.
- Design — mid-fi, "combine and refine." Do NOT simply promote the favorite from the last round — merge the strong parts of several concepts and linger in uncertainty one round longer than feels comfortable. Introduce real text and real components; keep a limited palette so detail stays bounded. Start working screen-to-screen navigation and per-screen interaction, with variants at the component level.
- Build/handoff — late-phase. Optimize for a new audience: colleagues and stakeholders, not yourself. Add annotations, connect screens with arrows, include every screen in the workflow, and add detail only at critical or novel interactions. The wireframe must be understandable with no author present. Danger of this phase: attachment — domain experts and developers must still be free to judge, cut, and override it.
What Makes a Wireframe Good
Judge a wireframe by what it causes, never by how much it resembles the product.
- It answered three questions before it existed. Write on page one of the file: Who uses this (persona or concrete role — "admins," "donors")? What are their goals (framed as user needs — nobody wants to sign up; they want to save progress)? What problem does it address (current pain, competitor gap)? A great solution to a poorly defined problem loses to a decent solution to a well-defined one. Skipping this note is the highest-impact mistake in the whole process.
- It was iterated. Good wireframes are survivors of many rounds, not first drafts polished. Treat every version as disposable; willingness to delete is the engine of quality.
- It exposed gaps. A wireframe that showed you a missing state, step, or use case has already paid for itself. Open-endedness is a feature: it prompts the ideation that closes those gaps.
- It invites action. Annotate, leave areas visibly unfinished on purpose, highlight deltas from the current product and the areas of least certainty. Detail budget: stop when effort-to-convey exceeds what the audience needs to know. The failure reaction is "OK — now what?"; the success test is that the next person can pick it up and run without you.
Choosing a Tool
- The only mandatory feature: it must not interrupt flow. The right tool visualizes ideas as fast as they arrive. Early phases: pen/paper or whiteboard are fully competitive with software.
- If software, require: a library of standard UI components (so mid/late-phase frames map to things developers can build) — and require the absence of fine-tuning: no pixel dimensions, no CSS properties, no interactive behavior. Those options are polish bait during ideation.
- More capable ≠ better. Constraints drive both speed and creativity; a tool that can render the real thing will tempt you to.
- Match tool to phase, not preference: solo divergence → whatever is fastest for you, including paper; group ideation → whiteboard (physical or digital) so everyone can draw; anything that must be revised, shared, or annotated → digital wireframing tool; anything interactive → you've left wireframing, use a prototyping tool and say so.
- Team-participation test: if only the designer can operate the tool, it's the wrong tool for early phases — wireframes work because everyone (PM, developer, stakeholder) can create and edit them.
Required Context
- What decision is pending — fidelity is chosen against a decision, never in the abstract.
- What is already validated vs still open. Fidelity may not exceed certainty.
- Who reviews it next, and what they will read the polish as meaning.
- How long it must survive — throwaway exploration or a durable reference.
- Who needs to edit it — if non-designers must contribute, the tool choice narrows.
Evaluation Procedure
- Write the who / goals / problem note. If you can't, stop — that's the finding.
- Name the pending decision, and the lowest fidelity that can answer it.
- Check certainty against the ladder: is anything rendered more finished than it is decided?
- Count the concepts. Below three at definition phase, you haven't diverged.
- Read the feedback you're getting: comments on fonts or colour mean the artifact is over-rendered — drop a level.
- Confirm the tool isn't offering pixel or CSS fine-tuning during ideation.
- Before sharing, check it stands without you.
Output Format
Decision pending: <what this artifact must answer>
Who / goals / problem: <the three answers>
Fidelity: <level> — because certainty is <what's validated>
Concepts explored: <n> (≥3 at definition phase)
Tool: <choice> — because <speed / editability / who must contribute>
Next level when: <the condition that unlocks moving up>
Quick Reference
| Situation | Rule |
|---|---|
| New feature or product | Start no-fi/low-fi; ≥3 distinct concepts before converging |
| Unsure what fidelity to use | Match fidelity to certainty; when in doubt, go lower |
| Feedback is about fonts/colors | Artifact over-rendered — drop a fidelity level |
| Structure agreed, refining interaction | Move up to mid-fi: real components, real labels, limited palette |
| "Make it look real" request | Separate comp/prototype; never inflate the wireframe |
| Handoff to developers | Late-phase: annotated, arrows, full flow, stands alone |
| First idea feels like a winner | Red flag — generate the other nine |
| Round one done, one favorite | Combine and refine across concepts; diverge once more before locking |
| How much detail to add late | Only at critical/novel interactions; stop at diminishing returns |
| Before drawing anything | Write who / goals / problem on page one |
| Picking a tool | Fastest one that doesn't interrupt flow; component library, no fine-tuning options |
| Non-designers want to contribute | Hand them the tool — low fidelity is the license for everyone to draw |
| Reviewer asks "is this the final design?" | Fidelity miscalibrated — roughen the artifact or reframe the review |
| Showing concepts to end users early | Low/mid-fi is fine for structure and flow questions; prototype only for interaction detail |
| Project wobbling after code started | Too late for wireframes to be cheap — wireframe the next change before coding it |
Anti-Patterns
| Mistake | Fix |
|---|---|
| Spec → polished mock → code, no ideation | Explore ≥3 low-fi concepts; test structure before investing in realism |
| Polishing during exploration (fonts, colors, pixels) | One color, rough lines, no styling until structure is signed off |
| Promoting the favorite after one round | Combine strengths of several concepts; alternate converge/diverge |
| "High-fidelity wireframe" | That's a prototype/comp — build it as a separate artifact |
| Wireframe needs its author to explain it | Annotations, screen-connecting arrows, every step of the flow included |
| Wireframing one screen of a multi-screen flow | Wireframe entry to exit; gaps live between screens |
| Skipping the who/goals/problem note | Write the three answers on page one before the first box |
| Getting attached to a late-phase wireframe | It's the idea's final exam, not its trophy — let experts cut it |
| Stakeholders signing off on branding | Review structure at low fidelity first; fidelity signals doneness whether you intend it or not |
| Tool with pixel/CSS fine-tuning during ideation | Switch to paper or a components-only wireframing tool |
| Lorem ipsum everywhere at mid-fi | Real headings, labels, and CTAs; lorem only for body copy |
| Three cosmetic variants of one concept | Vary structure (layout, flow, hierarchy), not decoration — or it's one concept |
| Converge-only funnel, no re-divergence | After each cut, allow a small diverge pass on the survivors (controlled convergence) |
| Adding interactivity "so they get it" | Interactivity makes it a prototype — annotate the behavior instead |
| Treating the wireframe as the deliverable | The understanding is the output; the file is the vehicle |
Companion Skills
| Situation | Co-fire |
|---|---|
| Defining the problem, users, and goals before frame one | dec-discovery-validation |
| Deciding what each screen exposes vs defers | dec-core-principles |
| Word-cutting and self-evidence check on mid/late frames | dec-krug-laws |
| Heuristic pass over a mid- or late-phase wireframe | usability-heuristics |
| Which proven flow pattern the screens should follow | userflow |
| Hierarchy, grouping, and grid inside a frame | layout-and-composition |
| Graduating from wireframe to polished visual design | hallmark |
Distilled from Wireframing for Everyone (Michael Angeles, Leon Barnard, Billy Carlson — A Book Apart, 2023), extended with production practice.