Learnability and Workflow

Identify and quantify learnability and workflow friction in product interfaces.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill learnability-and-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Learnability and Workflow
Source: https://github.com/nsalvacao/nsalvacao-claude-code-plugins/tree/main/plugins/solution-audit/skills/learnability-workflow
Command: npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill learnability-and-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Learnability and workflow quality determine how quickly users form an accurate mental model and complete tasks with minimal friction. This skill provides a structured audit framework to identify where onboarding, instructions, or steps cause confusion or delays.

Core Features & Use Cases

  • Identify the mental model and the 2–3 core concepts users must understand to use the tool effectively.
  • Map the primary user workflow from initial intent to task completion and flag friction points, context switches, and decision bottlenecks.
  • Propose concrete improvements to reduce cognitive load, simplify onboarding, and improve cross-scenario usability across common product journeys.

Quick Start

Audit a feature to surface learnability issues, document findings, and propose improvements.

Frequently Asked Questions about Learnability and Workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a user workflow for friction and learnability issues?

To audit a user workflow for friction, map the primary journey from initial intent to task completion, flagging context switches and bottlenecks to drive concrete usability improvements. This structured framework targets multi-step processes and dashboards.

What causes high cognitive load during feature onboarding?

High cognitive load during feature onboarding is caused by misaligned mental models, unclear instructions, and unflagged decision bottlenecks. Identifying the 2-3 core concepts users must understand helps quantify and reduce this workflow friction.

How do I map mental models to improve UX usability?

Mapping mental models to improve UX usability requires documenting the core concepts users need, then evaluating task-oriented workflows against them to surface friction points. This process reduces cognitive load and simplifies cross-scenario journeys.

What is the best way to identify decision bottlenecks in multi-step processes?

The best way to identify decision bottlenecks in multi-step processes is to map the primary user workflow from intent to completion. Flagging context switches and friction points reveals where cognitive load delays task completion.

Can I use this workflow audit framework for complex dashboards and forms?

Yes, you can use this workflow audit framework across common product journeys including complex dashboards, forms, and multi-step processes. It systematically assesses learnability and workflow friction across various task-oriented scenarios.