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.
Install
npx skills add mastepanoski/claude-skills --skill cognitive-walkthroughgit 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-walkthroughPersonal 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]
Details
- Skill name
cognitive-walkthrough- Repository
- mastepanoski/claude-skills
- 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
74mastepanoski/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.
Don Norman Principles Audit
74mastepanoski/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.
Gdpr Audit
74mastepanoski/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.
Access
43jeremylongshore/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".
Ab100 Lab Creator
42timothywarner-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.
Configure
43jeremylongshore/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".
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.