Wireframe collaboration
Skill jpoindexter/wireframe-skills/skills/wireframe-collaboration
Use when running a team wireframing session or design-studio workshop, breaking design-by-committee gridlock, involving engineers and PMs in design (or reining in a hijack), unblocking a solo-designer bottleneck, deciding who owns which wireframing decision, structuring PM→designer→engineer handoffs, resolving cross-role design disagreements, or adapting collaborative wireframing for remote and async teams.From its SKILL.md
npx -y skills add jpoindexter/wireframe-skills --skill wireframe-collaborationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 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.
SKILL.md
13.7 KB, ~3.0k tokens by cl100k_base, as published. Nobody here has run it
Wireframing as a Team
Overview
Wireframes have no customer value — nobody ships a wireframe. Their value is the collaboration they force: a shared, low-skill-barrier surface where PMs, engineers, and designers design together instead of throwing artifacts over silo walls. Teams fail at handoffs, not at sprints; treat the handoff as part of every role's job.
When to Use
- Kicking off a feature where PM, design, and engineering must align on structure before code
- Any org with a "design gap" — no dedicated designer, or a designer used as a pixel service. The term is Dan Olsen's (The Lean Product Playbook), who maps five levels of design maturity and observes that levels 1–4 all carry a design gap that product and engineering roles end up filling. That gap is precisely who this skill family is for.
- A solo designer is the bottleneck and other roles are idle waiting on mocks
- Deciding who drafts, who decides, and who consults on a design question
- Remote/distributed teams that need async design collaboration to work
- NOT for: running the critique itself once wireframes exist — that's wireframe-feedback
- NOT for: developer-facing spec/annotation packaging at the end — that's wireframe-handoff
Why Team Wireframing
What non-designers contribute:
- PMs — problem framing, user stories made visual, workflow-level wireflows, the "no" on scope
- Engineers — cheap-vs-expensive signals before design hardens, stress cases and edge-case flows, alternative solutions that are 90% of the UX at 30% of the cost, technical diagrams (a query flow is a wireframe too)
- Support, content, marketing, analysts — real user vocabulary, failure modes, and questions no one in the triad thought to ask
What it de-risks:
- Designs that never ship because engineering first sees them as a finished handoff
- Solutions to unvalidated problems (wireframes force the problem to be articulated first)
- Structural rework — workflow and layout are near-impossible to change post-code; fonts and colors aren't
- Single-point-of-failure design: one person's taste becomes the product's ceiling
Name the goal of every wireframe you share. The five purposes: articulation (visualize the problem), generation (many rough ideas, fast), iteration (cut to MVP), communication (align stakeholders / guide developers), validation (user tests and technical review before code). A wireframe shared without its purpose invites the wrong feedback.
Session Structure
Run collaborative sessions as a design studio: diverge alone, converge together. 5–7 participants; more than 8 splits into parallel sessions.
- Prep (before the session). Facilitator circulates a one-line problem statement, the target user, known constraints, and 2–3 reference screens 24h ahead. No solutions in the packet.
- Frame (5 min). Restate the problem aloud. Write it where everyone can see it — every dispute later gets tested against this sentence.
- Silent individual sketching (8 min). Everyone sketches — PM, engineers, everyone. Quantity over quality: aim for 6–8 thumbnail variations each (Crazy 8s pacing). Silence is the point: it blocks anchoring on the loudest voice.
- Round-robin share (3 min per person, timeboxed hard). Each person presents; others hold comments. Presenter states what problem each sketch attacks.
- Silent critique + dot vote (5 min). Written comments and 3 dots each on specific elements, not whole sketches — before any discussion, so votes aren't social.
- Converge (10–15 min). Discuss the top-voted elements only. One person (usually the designer) is named to consolidate into a single wireframe set after the session — the group generates; one hand synthesizes.
- Close with owners. Name who consolidates, who reviews, and the date of round two. A session without a named next round is theater.
Iterate in rounds — minimum three: round 1 after clarifying requirements with the PM, round 2 after PM feedback, round 3 after the engineer has reviewed. The engineer must see the wireframes before they're "done" — their estimates and constraints legitimately change what the PM decides to pursue.
Keep fidelity low in sessions. Basic shapes + annotations. Detail signals "finished" and kills contribution; polish is the enemy of participation.
Annotate what the UI can't say. Four cases that earn an annotation: error/edge cases, off-screen or background behavior, design rationale, and decision history. Describe secondary states in words ("same as X screen") rather than drawing every state.
Roles & Ownership
Too much ownership by one role creates silos; too little creates apathy. Default split — adjust explicitly, in writing, if your team differs:
| Decision | Drafts | Decides | Consulted |
|---|---|---|---|
| Problem statement & requirements | PM | PM | Design, Eng, Support |
| Scope / MVP cuts | PM | PM | Design, Eng |
| Screen structure, flow, layout | Designer | Designer | PM, Eng |
| Interaction & UI patterns | Designer | Designer | Eng (feasibility) |
| Feasibility, effort, build-vs-cut tradeoffs | Eng | Eng | Designer, PM |
| Technical flows (queries, sync, background jobs) | Eng | Eng | Designer |
| Annotations & rationale | Author of the wireframe | — | Everyone downstream |
| Visual polish (type, color, spacing) | Designer | Designer | Deferred — not a wireframe concern |
Handoff rules (each is a working agreement, not a vibe):
- Document the current handoff chain once: every artifact, who receives it, when. The gaps become visible immediately.
- Each role states, on record, what they need to do their job and in what form. People are never asked; assumptions fill the silence.
- A role's work is not done until the next role confirms they have what they need. Put the transition step in the process itself.
- Solo operator wearing multiple hats? Run the handoff anyway — each phase has distinct goals and deliverables even when it's one person.
- Notification granularity: active collaborators get per-change notifications; upstream/downstream roles subscribe to digests. Nobody should mute the project to survive it.
Handling Challenges
- Dominant voices / groupthink — structure beats willpower: silent sketching before any talk, hard round-robin timeboxes, written critique before spoken, votes cast before discussion.
- HiPPO (highest-paid person's opinion) — their sketch enters the pool like everyone else's; dots are cast silently and counted before they speak. If they pre-empt, the facilitator restates the problem sentence and asks which sketch best answers it.
- Feature creep mid-session — ask "what problem are we solving?" out loud, pointing at the framed statement. Saying yes to every request is how products get too complex to want.
- Skepticism of design / "know-it-all designer" residue — every design decision ships with its rationale; when contested, offer to settle it with a quick usability test instead of debate. Decisions backed by observed users end arguments that taste cannot.
- Cross-role disagreement — assume misunderstanding before malice. Ask each side what's most important about their position; usually the constraint and the ideal are compatible once separated. A slightly-worse-for-users solution that is dramatically faster/safer to build can be the right call — make that tradeoff explicitly, never silently.
- Remote adaptation — same studio structure over a real-time co-editing canvas; cameras optional, timeboxes mandatory; sketch on paper and photograph if tooling is friction.
- Async adaptation — replace steps 3–5 with a 48h window: each contributor posts sketches to a shared board by deadline, comments via numbered callouts, votes by emoji/dots by a second deadline; the consolidator synthesizes and posts round two. Digest subscriptions keep non-active roles informed without drowning them.
- Trust deficit — collaboration quality is capped by relationship quality. Ask colleagues for help (people invest in what they've helped), learn one thing about the constraint-world of each adjacent role, and fix communication on your side first: if the next person downstream is unhappy, change what you're sending.
Required Context
- Who is in the room and what each owns — product, design, development have different calls.
- Whether a design gap exists — no dedicated designer changes who drives.
- The decision the session must produce. A session without one is a meeting.
- Remote, in-person, or async, and the tool everyone can actually operate.
- The known friction — a dominant voice, a stalled debate, design-by-committee.
Evaluation Procedure
- Name the decision the session exists to reach, and who owns it.
- Confirm the tool lets everyone draw, not just the designer.
- Time-box divergence and convergence separately; don't let one eat the other.
- Check participation: did the quiet roles contribute artifacts, not just comments?
- Route each open question to the role that owns it rather than deciding by volume.
- Close with the decision, the owner, and the next artifact — in writing.
- Confirm nobody left believing a different outcome than what was recorded.
Output Format
Session goal: <the decision to reach> · Owner: <role>
Participants and their calls: <role → what they decide>
Format: <in-person | remote | async> · Tool: <one everyone can edit>
Diverged: <n concepts, by whom> → Converged on: <what, and why>
Open, routed: <question → owning role>
Recorded decision: <one sentence everyone would agree to>
Quick Reference
| Situation | Pattern |
|---|---|
| Kicking off a feature with the triad | Design studio: frame 5' → silent sketch 8' → share 3'/person → vote → converge |
| Session size | 5–7 people; >8 → split into parallel studios |
| Who sketches | Everyone — no spectators, no skill prerequisite |
| Preventing anchoring | Individual silent sketching before any sharing |
| Preventing social voting | Written critique + dots before discussion |
| Loud voice / HiPPO | Timeboxed round-robin; votes counted before seniors speak |
| Rounds of wireframes | Minimum three: post-requirements, post-PM-feedback, post-eng-review |
| Fidelity in team sessions | Low — boxes and annotations; polish kills participation |
| What to annotate | Edge cases, off-screen behavior, rationale, decision history |
| PM's wireframes | Problem and workflow visualization — never a prescribed solution |
| Designer's output | Many deliberately-incomplete options for critique, not one design for approval |
| Engineer's review | Cheap-vs-expensive flags + alternative solutions, before design hardens |
| Ownership dispute | Drafts/Decides/Consulted table, agreed in writing |
| Handoff definition | Done = next role confirms they have what they need |
| Feature creep in session | Point at the framed problem statement |
| Design decision contested | Rationale first; quick usability test as tiebreaker |
| Async/remote team | Same studio in two 48h windows: post-by-deadline, vote-by-deadline, consolidate |
| Post-handoff awareness | Per-change notifications for active roles; digests for everyone else |
Anti-Patterns
| Mistake | Fix |
|---|---|
| Pixel-perfect designs emailed to engineering as "done" | Engineers review low-fi wireframes in round 3, before anything is final |
| PM spec prescribes the solution | PM wireframes the problem and workflow; solutions emerge in the studio |
| Designer presents one polished design for approval | Multiple rough concepts presented for critique |
| One round of wireframes, then build | Three rounds minimum, engineer in the loop before round 3 |
| Group brainstorming from minute zero | Silent individual sketching first, then share |
| Discussion before voting | Silent written critique + dots first — votes precede talk |
| Silence in the session read as agreement | Round-robin: every person shares, timeboxed |
| Only "the designer" sketches | Everyone sketches; wireframes need no prerequisite skill |
| Wireframes shared with no stated purpose | Name the goal (articulate/generate/iterate/communicate/validate) with every share |
| Drawing every state and animation frame | One state drawn; the rest described in annotations ("same as X") |
| Rationale kept in the designer's head | Every contested decision ships with its why, on the wireframe |
| Nobody owns the handoff | Handoff written into each role's definition of done |
| Saying yes to every feature request in-session | Re-ask "what problem are we solving?" against the framed statement |
| Engineer feasibility feedback arrives after build starts | Feasibility flags are a named session input, round 3 at the latest |
| Blaming the downstream role for bad output | Audit what you're sending them first; most conflict is misunderstanding |
Companion Skills
| Situation | Co-fire |
|---|---|
| Running critique on the session's output | wireframe-feedback |
| Problem isn't validated before sketching | dec-discovery-validation |
| Scope fights, MVP cuts, backlog ranking | dec-prioritization-frameworks |
| Team converged suspiciously fast | blind-red-team |
| Two roles deadlocked on an approach | blind-steelman |
| Choosing which flow patterns to sketch | userflow |
Distilled from Wireframing for Everyone (Michael Angeles, Leon Barnard, Billy Carlson — A Book Apart, 2023), extended with production practice.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.