agentleFS
jpoindexterjpoindexter/wireframe-skills/skills/wireframe/SKILL.md

wireframe

Skill1 starsChanged 4 months agoMITView on GitHub

Use when the user invokes /wireframe, asks to wireframe, sketch, or block out a screen, flow, or app before high-fidelity design or code — or when a build is jumping straight to polished UI without structural exploration, stakeholders demand pixel-perfect too early, or an existing wireframe needs review, critique, or handoff. Dispatcher that runs the full wireframe-* family and co-fires the matching design skills.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use make-tweakable.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • bluzirSkill

    make-tweakable

    Add an in-artifact floating Tweaks panel that lets the user adjust colors, fonts, spacing, layout variants live in the preview. Persists via claude-pipe pattern (pending.yaml + apply-tweaks skill).

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 11 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Rule: if you state something as the book's, name the origin.

    line 59
  2. Distinctive:

    Always accompanied by: screen inventory (purpose / primary action / empty-loading-error states), open questions, and annotations per …

    line 69
  3. Distinctive:

    If one line and ambiguous, dispatch on the most likely reading and state the assumption.

    line 80
  4. Distinctive:

    Do the work under the combined rules.

    line 86
  5. Distinctive:

    Check the output against every loaded skill's Anti-Patterns table before presenting.

    line 87

“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Wireframe — Full-Family Dispatcher

Overview

Entry point for the wireframe-* skill set — the complete wireframing discipline distilled from Wireframing for Everyone (A Book Apart, 2023): fundamentals → ideation → elements → principles → collaboration → feedback → handoff. /wireframe loads the whole family so every phase of the work is governed, then co-fires the companion design skills the task touches. Router plus canon, not a recital.

When to Use

  • /wireframe invoked, with or without arguments
  • Any request to wireframe, sketch, mock up structure, or "block out" screens before visual design
  • A project is skipping ideation — first idea heading straight to high fidelity or code
  • Reviewing, critiquing, presenting, or handing off wireframes
  • NOT for visual styling decisions (color, type, elevation) — that's /design territory after structure is settled
  • NOT for pure flow-logic questions with no screen structure at stake — use userflow directly

The Dispatch Process

  1. Resolve the target. Argument text first; else the surface active in the conversation; else inspect the project (routes, screens). Ask at most one question, only if it changes the work.
  2. Load the entire wireframe family via the Skill tool (read skills/<name>/SKILL.md in other harnesses) — all seven, in this order:
    • wireframe-fundamentals — fidelity choice, tool choice, what "good" means
    • wireframe-ideation — structure before screens; divergent exploration
    • wireframe-elements — components, patterns, page templates
    • wireframe-principles — hierarchy, alignment, clarity at grayscale
    • wireframe-collaboration — team sessions, roles, ownership
    • wireframe-feedback — critique structure, acting on feedback
    • wireframe-handoff — presenting, annotation, shipping to build
  3. Co-fire companion design skills from the routing table below — max 4 per pass, chosen by what the task actually touches.
  4. State the load in one line ("Running wireframe family + flow-app-shell, components-and-states") and do the work under their combined rules. Phase-specific skill wins conflicts (wireframe-handoff beats wireframe-ideation on an annotation question).
  5. Check output against every loaded skill's Anti-Patterns section before presenting.

Companion Routing Table

Task signalCo-fire
New app / greenfield screensuserflow (routes flow-app-shell, flow-navigation, flow-onboarding), layout-and-composition
A specific flow (auth, checkout, search, settings...)userflow — it routes the right flow-* skill
Component-level questions (what control, what states)components-and-states
Layout, spacing, grid decisions at wireframe fidelitylayout-and-composition, grid-and-spacing
Information architecture, nav structureflow-navigation
Labels, microcopy, real-content-over-lorem callsux-writing-and-content
Critique or design-review sessiondec-nielsen-heuristics, usability-heuristics
Named-principle reasoning (hierarchy "why", cognitive load)dec (routes the dec-* canon)
Moving up-fidelity after wireframes are approveddesign (routes the visual family), hallmark for taste stakes
Wireframing an iOS-native surfaceios (routes the ios-* family) — wireframe family still governs structure
Pre-commit sanity check on a chosen directionblind-premortem, blind-consider-the-opposite

Traceability

references/source-map.md maps the book's seven chapters onto these seven skills and lists all 39 sources the book cites, with the skill that carries each. Use it to attribute a claim, or to check whether something is the book's position or this pack's extension. Sibling skills reach it at ../wireframe/references/source-map.md.

Rule: if you state something as the book's, name the origin. If you state something the book doesn't say, mark it as production practice. The skills are explicitly "extended," and that extension must stay visible.

Deliverable

For any request that produces or reviews wireframes, emit the wireframe as structured output the user can act on:

  • ASCII/box wireframes inline for quick structural discussion — every region labeled, hierarchy shown by position and size
  • HTML grayscale wireframes (single self-contained file, no color beyond grays, real labels, no lorem where a decision hides) when the user wants something clickable or presentable
  • Always accompanied by: screen inventory (purpose / primary action / empty-loading-error states), open questions, and annotations per wireframe-handoff when build is the next step

Required Context

Establish before dispatching:

  • The surface — which screen, flow, or app. Argument text, else the active surface, else inspect the repo.
  • The phase — is structure unknown (ideation), agreed (elements/principles), or settled (handoff)?
  • The audience for the output — you, the team, stakeholders, or developers. Fidelity follows.
  • Whether an artifact already exists to review, or this is greenfield.
  • Constraints that pre-decide things — an existing design system, platform, or locked IA.

If one line and ambiguous, dispatch on the most likely reading and state the assumption.

Evaluation Procedure

  1. Resolve the target and name the phase.
  2. Load the family; pick ≤4 companions from the routing table.
  3. Do the work under the combined rules; phase-specific skill wins conflicts.
  4. Check the output against every loaded skill's Anti-Patterns table before presenting.
  5. Confirm the deliverable carries a screen inventory and open questions, not just frames.
  6. State what you did not resolve — the open questions are part of the artifact.

Output Format

Loaded: wireframe family + <companions>
Phase: <ideation | structure | principles | handoff>  ·  Fidelity: <no-fi…late-phase>
<the wireframe — ASCII/box inline, or grayscale HTML if it must be presentable>
Screen inventory: <screen> — purpose / primary action / empty+loading+error
Open questions: <what this artifact does not yet answer>
Anti-pattern check: <which skills' tables were applied>

Quick Reference

SituationAction
/wireframe a settings page for XLoad family + userflow(flow-settings) + components-and-states; produce wireframe + inventory
/wireframe mid-project, no argsInfer surface from recent work; inspect repo if needed
"Review this wireframe"Family + dec-nielsen-heuristics; audit against every Anti-Patterns section
"Ready for build"wireframe-handoff leads; produce annotation package
User named a specific wireframe-* skillInvoke it directly — skip the dispatcher

Anti-Patterns

MistakeFix
Summarizing family skills from memoryLoad every SKILL.md — the value is in the specifics
Jumping to visual design because the tool renders prettyGrayscale, boxes, real labels; /design comes after approval
Co-firing every companion skill "to be safe"Family always; companions max 4, chosen by the routing table
Producing one layout and calling it donewireframe-ideation demands divergent alternatives before converging
Shipping a wireframe with lorem over key decisionsReal labels wherever a word IS the design decision

Part of the wireframe-skills family — github.com/jpoindexter/wireframe-skills.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.