Cognitive Walkthrough

Deep-dive usability evaluation of specific user tasks. Simulates novice user cognition step-by-step to identify learnability issues, unclear actions, and points of confusion.

74 stars 9 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mastepanoski/claude-skills --skill cognitive-walkthrough
Manual install
git clone --depth 1 https://github.com/mastepanoski/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/cognitive-walkthrough ~/.claude/skills/cognitive-walkthrough

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Cognitive Walkthrough

This skill enables AI agents to perform a **task-specific usability evaluation** using the Cognitive Walkthrough method, a technique that simulates how users (especially novices) think through completing specific tasks in an interface.

Unlike broad heuristic evaluations, Cognitive Walkthrough provides deep analysis of particular user journeys, identifying where users get stuck, confused, or make errors.

Use this skill when you need granular, task-focused insights into learnability and ease of first use.

Combine with "Nielsen Heuristics" for general usability, "Don Norman Principles" for intuitive design, or "WCAG Accessibility" for inclusive access.

## When to Use This Skill

Invoke this skill when:
- Analyzing specific user tasks (e.g., "complete checkout", "upload a file")
- Evaluating learnability for first-time users
- Identifying points of confusion in a flow
- Debugging why users fail to complete tasks
- Assessing onboarding or critical user journeys
- Comparing alternative designs for the same task
- Preparing for usability testing (hypothesis generation)

## Inputs Required

When executing this walkthrough, gather:

- **task_description**: Specific task to evaluate (e.g., "Create a new account and add first item to wishlist") [REQUIRED]
- **user_persona**: Target user type (novice/intermediate/expert, demographics, goals, prior experience) [REQUIRED]
Read the full skill on GitHub

Details

Skill name
cognitive-walkthrough
Path
skills/cognitive-walkthrough/SKILL.md
License
MIT
Repo updated
29 October 2026

FAQ

What does the Cognitive Walkthrough skill do?

Deep-dive usability evaluation of specific user tasks. Simulates novice user cognition step-by-step to identify learnability issues, unclear actions, and points of confusion.

How do I install the Cognitive Walkthrough skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add mastepanoski/claude-skills --skill cognitive-walkthrough. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Cognitive Walkthrough popular?

It lives in mastepanoski/claude-skills, which has 74 GitHub stars and 9 forks.

Related skills

AI Assessment Scale

74

mastepanoski/claude-skills

Evaluate AI contribution in software projects using the AI Assessment Scale (AIAS) v2 5-level framework. Adapt the education-focused framework for transparent project documentation across development stages.

AI, LLMs & Agents

Don Norman Principles Audit

74

mastepanoski/claude-skills

Evaluate UX/UI using Don Norman's 7 fundamental design principles from The Design of Everyday Things. Audit discoverability, affordances, signifiers, feedback, mapping, constraints and conceptual models.

Frontend & Design

Gdpr Audit

74

mastepanoski/claude-skills

GDPR compliance audit of code, plans, schemas, or IaC. Produces a findings report with article citations, severity, confidence, and fixes; flags evidence gaps. Not a substitute for a DPO/lawyer.

Research & Science

Access

43

jeremylongshore/claude-code-slack-channel

Manage Slack channel access control — pairing, allowlist, channel opt-in. Use when approving a pairing code, changing the DM policy, editing the user allowlist, or opting a channel in or out. Trigger with "/slack-channel:access", "pair my slack account", "add user to slack allowlist", or "opt in a slack channel".

Productivity & Notes32

Ab100 Lab Creator

42

timothywarner-org/ab100

Create short AB-100 practice labs (15-25 minutes) that are executable and self-validating. Every lab includes prerequisites, exact tasks, validation steps, expected outputs, and cleanup. Scope covers agent design walkthroughs, Copilot Studio authoring, Microsoft Foundry tool configuration, ALM patterns, and governance controls. Use when the user asks for a hands-on lab, practice exercise, or guided walkthrough.

Productivity & Notes32

Configure

43

jeremylongshore/claude-code-slack-channel

Configure Slack channel tokens (bot token + app-level token). Use when writing or rotating the Slack bot and app-level tokens for the slack-channel plugin. Trigger with "/slack-channel:configure", "configure slack tokens", or "set up my slack bot token".

Productivity & Notes32

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.