agentsclimarketplace

Wireframe collaboration

Skill jpoindexter/wireframe-skills/skills/wireframe-collaboration

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-collaboration

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 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.

SKILL.md

13.7 KB, 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.

  1. 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.
  2. Frame (5 min). Restate the problem aloud. Write it where everyone can see it — every dispute later gets tested against this sentence.
  3. 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.
  4. Round-robin share (3 min per person, timeboxed hard). Each person presents; others hold comments. Presenter states what problem each sketch attacks.
  5. 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.
  6. 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.
  7. 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:

DecisionDraftsDecidesConsulted
Problem statement & requirementsPMPMDesign, Eng, Support
Scope / MVP cutsPMPMDesign, Eng
Screen structure, flow, layoutDesignerDesignerPM, Eng
Interaction & UI patternsDesignerDesignerEng (feasibility)
Feasibility, effort, build-vs-cut tradeoffsEngEngDesigner, PM
Technical flows (queries, sync, background jobs)EngEngDesigner
Annotations & rationaleAuthor of the wireframeEveryone downstream
Visual polish (type, color, spacing)DesignerDesignerDeferred — 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

  1. Name the decision the session exists to reach, and who owns it.
  2. Confirm the tool lets everyone draw, not just the designer.
  3. Time-box divergence and convergence separately; don't let one eat the other.
  4. Check participation: did the quiet roles contribute artifacts, not just comments?
  5. Route each open question to the role that owns it rather than deciding by volume.
  6. Close with the decision, the owner, and the next artifact — in writing.
  7. 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

SituationPattern
Kicking off a feature with the triadDesign studio: frame 5' → silent sketch 8' → share 3'/person → vote → converge
Session size5–7 people; >8 → split into parallel studios
Who sketchesEveryone — no spectators, no skill prerequisite
Preventing anchoringIndividual silent sketching before any sharing
Preventing social votingWritten critique + dots before discussion
Loud voice / HiPPOTimeboxed round-robin; votes counted before seniors speak
Rounds of wireframesMinimum three: post-requirements, post-PM-feedback, post-eng-review
Fidelity in team sessionsLow — boxes and annotations; polish kills participation
What to annotateEdge cases, off-screen behavior, rationale, decision history
PM's wireframesProblem and workflow visualization — never a prescribed solution
Designer's outputMany deliberately-incomplete options for critique, not one design for approval
Engineer's reviewCheap-vs-expensive flags + alternative solutions, before design hardens
Ownership disputeDrafts/Decides/Consulted table, agreed in writing
Handoff definitionDone = next role confirms they have what they need
Feature creep in sessionPoint at the framed problem statement
Design decision contestedRationale first; quick usability test as tiebreaker
Async/remote teamSame studio in two 48h windows: post-by-deadline, vote-by-deadline, consolidate
Post-handoff awarenessPer-change notifications for active roles; digests for everyone else

Anti-Patterns

MistakeFix
Pixel-perfect designs emailed to engineering as "done"Engineers review low-fi wireframes in round 3, before anything is final
PM spec prescribes the solutionPM wireframes the problem and workflow; solutions emerge in the studio
Designer presents one polished design for approvalMultiple rough concepts presented for critique
One round of wireframes, then buildThree rounds minimum, engineer in the loop before round 3
Group brainstorming from minute zeroSilent individual sketching first, then share
Discussion before votingSilent written critique + dots first — votes precede talk
Silence in the session read as agreementRound-robin: every person shares, timeboxed
Only "the designer" sketchesEveryone sketches; wireframes need no prerequisite skill
Wireframes shared with no stated purposeName the goal (articulate/generate/iterate/communicate/validate) with every share
Drawing every state and animation frameOne state drawn; the rest described in annotations ("same as X")
Rationale kept in the designer's headEvery contested decision ships with its why, on the wireframe
Nobody owns the handoffHandoff written into each role's definition of done
Saying yes to every feature request in-sessionRe-ask "what problem are we solving?" against the framed statement
Engineer feasibility feedback arrives after build startsFeasibility flags are a named session input, round 3 at the latest
Blaming the downstream role for bad outputAudit what you're sending them first; most conflict is misunderstanding

Companion Skills

SituationCo-fire
Running critique on the session's outputwireframe-feedback
Problem isn't validated before sketchingdec-discovery-validation
Scope fights, MVP cuts, backlog rankingdec-prioritization-frameworks
Team converged suspiciously fastblind-red-team
Two roles deadlocked on an approachblind-steelman
Choosing which flow patterns to sketchuserflow

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.