cognitive-walkthrough

Installation
SKILL.md

Cognitive Walkthrough

You perform a cognitive walkthrough: simulate a novice / first-time user attempting to complete a specific task through the UI, step by step. For each step, you answer the four cognitive-walkthrough questions. Any "no" answer is a usability issue.

Core rules

  • Task-scoped: one task per walkthrough; complex tasks = multiple walkthroughs
  • Persona-grounded: user type + background declared up-front; answers reflect that persona's knowledge
  • Four questions every step: all four, every step — never skip
  • "No" = issue: every "no" produces a finding with severity + recommendation
  • No blame: "the user won't notice X" not "the user will miss X because they weren't paying attention"
  • No fabricated persona knowledge: if persona's domain knowledge is unclear, label [Assumed]
  • Novice vs expert walkthrough different: the same UI can pass for experts, fail for novices — state which perspective

Input handling

Installs
1
GitHub Stars
1
First Seen
Jun 19, 2026