MCPInstall

layers-interaction-flow

Techniques for mapping interaction structure and flow — places, affordances, edge cases, and failure paths — without committing to visual form

Installs
2K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jamiemill/layers-skills --skill layers-interaction-flow
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads layers-interaction-flow automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

/layers-interaction-flow

Assumes /layers-intro has been loaded. This skill is a library of techniques, not a script — see "How to use these skills" there.

The interaction structure and flow layer defines how a person interacts with the product: the places they navigate, the affordances available, the content presented, and the flow between states. It sits above the conceptual model (which defines what exists) and below the surface (which defines how it looks).

A breadboard is always for a particular user in a particular situation doing a particular job. Know which job story before you start.


The decisions this layer makes

  • The distinct places this flow moves through
  • What the user can do in each place, and where each action leads
  • What content each place needs to show
  • What happens on failure paths, empty states, and edge cases
  • Whether the flow is as simple as it can be while still serving the job

If the conceptual model beneath isn't stable, flows built on it often need redoing — check that first.


Disciplines — what keeps a flow honest

  • Every affordance has a named destination. "Submit → where?" If you can't name it, it's an unmade decision.
  • Edges are required steps, not afterthoughts. Breadboard the failure paths (validation, server error, disconnection, timeout, concurrent edit), the empty and loading states, the post-action state, and the cancel path. Each gap is an unmade design decision — name it.
  • No broken objects. For each conceptual-model object in this flow, its attributes and actions should be available together — not scattered across screens with no cross-linking.
  • No isolated objects. Each model relationship should be visible and navigable in the flow, or there should be a deliberate decision that it needn't be.
  • Vocabulary matches the model's ubiquitous language.
  • Naming places is a design decision — descriptive and user-meaningful ("Referral dashboard", not "Page 3").
  • Keep it minimal. More than 5–6 places for a single job story is a signal to look for what can be collapsed.

Breadboard notation

Place name
- affordance → destination place
- affordance → destination place
[ content shown in this place ]

Techniques

Breadboarding is the default; the rest serve particular situations.

TechniqueUse it when
Breadboarding (Ryan Singer / Shape Up)Default. Text notation that forces interaction logic to be settled before visual design makes changes expensive.
Walk the flow as the userNarrate: "I'm a user who [situation]. I arrive at [place], I see [content], I want to [motivation], so I [affordance]…" Walk the happy path, then every edge. The fastest way to find unmade decisions.
User story mapping (Jeff Patton)Complex product, many user types, incremental planning. Activities → tasks → stories across a timeline.
Task analysisRedesigning an existing flow — decompose the current task to find where friction, errors, and workarounds concentrate.
Service blueprintingFlow spans channels or involves backstage operations (staff, systems, third parties).
Critical User JourneysDeciding which flow to work on — the minimal path to core value (high-traffic, high-revenue, metric-critical).
Flow diagram (graph LR)Orientation only — flow through time reads left to right. The text breadboard stays the primary artefact; the diagram loses conditional detail.

Working with the designer

Settle which job story the flow serves, where the user starts, and what success looks like. If redesigning, describe the current flow first — it reveals decisions already made, many of them unintentionally. Then name the places, map affordances and destinations, and walk the flow including its edges, applying the disciplines above. Conditions — when an affordance is or isn't available — are often where the real decisions hide.

Offer the technique that fits: breadboarding for most flows, task analysis for a redesign, story mapping when there's a lot to plan. Do the next useful thing, not all of them.

Capture only the residue: the breadboard (places, affordances, destinations, content, key conditional states), a flow diagram if it aids orientation, the open decisions (gaps and unresolved edge cases), and risks that depend on unsettled lower-layer decisions.

A breadboard defines interaction logic without committing to visual form. Before moving to surface, make sure the conceptual model beneath is stable.

FAQ

What does the layers-interaction-flow skill do?

Techniques for mapping interaction structure and flow — places, affordances, edge cases, and failure paths — without committing to visual form

How do I install layers-interaction-flow?

Run npx skills add https://github.com/jamiemill/layers-skills --skill layers-interaction-flow in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/layers-interaction-flow/ (personal) or .claude/skills/layers-interaction-flow/ (project).

Which AI agents can use layers-interaction-flow?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is layers-interaction-flow safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains layers-interaction-flow?

It is published by jamiemill in jamiemill/layers-skills. It has 1,965 recorded installs.

More from jamiemill/layers-skills

View all →

layers-conceptual-model

jamiemill/layers-skills

Techniques for defining the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

2K installs

layers-intro

jamiemill/layers-skills

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

2K installs

layers-product-strategy

jamiemill/layers-skills

Techniques for connecting user opportunities to business outcomes and solution bets, and testing the riskiest assumptions cheaply

Testing & QA2K installs

layers-surface

jamiemill/layers-skills

Techniques for auditing and deciding the surface against the layers below — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

layers-orient

jamiemill/layers-skills

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

Security2K installs

layers-domain

jamiemill/layers-skills

Techniques for mapping a domain's concepts, terminology conflicts, and bounded contexts — the raw material the conceptual model is built from

2K installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs