cognitive-walkthrough

Evaluate user tasks with a four-question framework to uncover learnability issues.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/kennyolofsson23-netizen/claude-code-config --skill cognitive-walkthrough-kennyolofsson23-netizen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cognitive-walkthrough
Source: https://github.com/kennyolofsson23-netizen/claude-code-config/tree/main/skills/cognitive-walkthrough
Command: npx skills add https://github.com/kennyolofsson23-netizen/claude-code-config --skill cognitive-walkthrough-kennyolofsson23-netizen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Cognitive Walkthrough skill helps practitioners identify learnability barriers by simulating novice user cognition across specific tasks, revealing where users get stuck or confused.

Core Features & Use Cases

  • Task-focused walkthrough with per-action analysis using four evaluation questions (Q1–Q4)
  • Stepwise decomposition of tasks into atomic actions
  • Generation of a structured walkthrough report with findings and recommendations
  • Suitable for onboarding assessments, feature flows, and critical user journeys to uncover first-use issues

Quick Start

Define a target task and run a step-by-step cognitive walkthrough to reveal learnability issues for first-time users.

Frequently Asked Questions about cognitive-walkthrough

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

FAQPage Schema
How do I identify learnability issues in onboarding flows?

A cognitive walkthrough identifies learnability issues by simulating novice user cognition across specific tasks. It decomposes onboarding flows into atomic actions and applies a four-question framework to reveal where first-time users struggle or get confused.

What is a cognitive walkthrough in user research?

A cognitive walkthrough is a usability evaluation method that simulates first-time user behavior to uncover learnability barriers. It uses a four-question framework applied stepwise to each action within a task journey to document where users might struggle.

How do I conduct a task analysis for first-time users?

Conduct task analysis for first-time users by breaking down target tasks into stepwise atomic actions. Evaluate each action using a four-question framework to assess learnability, then generate a structured walkthrough report with findings and recommendations.

Can I use a cognitive walkthrough for evaluating feature flows?

Yes, you can use a cognitive walkthrough for evaluating feature flows. It is suitable for assessing critical user journeys and task-specific interfaces, helping you uncover first-use issues by documenting stepwise actions and generating a formal walkthrough report.

What is the best way to evaluate interface learnability for new tasks?

The best way to evaluate interface learnability is running a task-focused cognitive walkthrough. This approach decomposes interfaces into stepwise actions, applies a four-question evaluation framework, and outputs a formal report detailing findings and recommendations.

When should I not use a cognitive walkthrough for usability testing?

You should avoid a cognitive walkthrough when evaluating overall system utility rather than first-time learnability. It focuses strictly on task-specific journeys and onboarding flows, providing stepwise documentation of novice cognition rather than broad usability metrics.