Skip to main content
skill CX Codex

cognitive-design — Claude Code skill: why designs work

cognitive-design is a Claude Code skill that explains design choices through cognitive psychology. Apply it to interfaces, dashboards, data visualizations, and educational content.

no license 134 installs ★ 203 updated 2026-09-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add lyndonkl/claude --skill cognitive-design -a claude-code
Open on GitHub

What cognitive-design does

cognitive-design replaces guesswork with principles. It teaches how to manage user attention, respect working memory limits (around 4±1 chunks), apply Gestalt grouping, and encode information visually so it's easier to parse. The skill includes three frameworks: Cognitive Design Pyramid rates design quality across four tiers (perceptual efficiency, cognitive coherence, emotional engagement, behavioral alignment); Design Feedback Loop maps the cycle of perception-interpretation-decision-action; Three-Layer Visualization Model connects data representation to cognitive interpretation.

Resources cover foundations (why attention and memory matter, preattentive processing, visual salience) and domain-specific guidance for data visualization, product/UX design, and educational design. A quick three-question check—Is hierarchy clear? Can the user avoid memorizing information that could be shown? Will a stranger understand in 5 seconds?—works as a rapid gate. Works alongside design-evaluation-audit for systematic reviews, cognitive-fallacies-guard to catch perceptual tricks, and visual-storytelling-design for data narrative.

What it helps with

  • pick the right chart type for the analysis task
  • arrange interface elements so they're obvious at a glance
  • reduce how much users must hold in working memory
  • design learning materials that stick
  • justify design decisions with research instead of taste

Example prompts for the agent

  • Design a dashboard dashboard for analytics; help me apply Cognitive Design Pyramid
  • Why does this chart feel harder to read than it should? Check it against preattentive processing
  • What's the right way to organize form fields to minimize cognitive load?

How to install cognitive-design

1Skills CLI (Vercel)

npx skills add lyndonkl/claude --skill cognitive-design -a claude-code

2Manually: put the files in place

~/.claude/skills/cognitive-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cognitive-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cognitive-design

How do I install cognitive-design in Claude Code?

Run npx skills add lyndonkl/claude --skill cognitive-design -a claude-code, then open ~/.claude/skills/cognitive-design/SKILL.md.

What does cognitive-design do?

It explains design through cognitive science—why visual hierarchies work, how much users can remember without aid, which chart types match which tasks. Helps you build interfaces, dashboards, and visualizations that are faster to understand and harder to misread.

What frameworks does it include?

Cognitive Design Pyramid (four-tier quality model), Design Feedback Loop (perception to action cycle), and Three-Layer Visualization Model (data to visual encoding to interpretation). Each structures a different design problem.

Similar skills

All skills for Design →

From the same set49

The whole set →
deliberation-debate-red-teaming deliberation-debate-red-teaming is a Claude Code skill that tests plans and designs through adversarial viewpoints, uncovering assumptions, operational hazards, and security gaps before launch. CX Codex +1 139installs design-of-experiments design-of-experiments creates structured factorial and Taguchi test designs to evaluate multi-parameter systems. It minimizes test iterations while mapping how variable interactions impact performance. CX Codex +1 139installs career-document-architect career-document-architect — a skill for crafting and refining career documents in academia: research statements, teaching statements, diversity statements, CVs, and biosketches. CX Codex +1 135installs focus-timeboxing-8020 focus-timeboxing-8020 is a Claude Code skill combining the 80/20 rule, timeboxing, and deep work. It helps prioritize tasks and protect time for complex work. CX Codex +1 135installs morphological-analysis-triz morphological-analysis-triz guides engineering concept exploration through Zwicky morphological boxes and TRIZ principles. It generates technical options and resolves design trade-offs before prototyping. CX Codex +1 130installs dialectical-mapping-steelmanning The dialectical-mapping-steelmanning skill examines opposing arguments and looks for options beyond an either-or choice. Use it when a discussion is stuck in a binary frame. CX Codex +1 130installs academic-letter-architect academic-letter-architect — a skill for writing academic recommendation letters with specific examples, comparative statements, and calibrated enthusiasm. CX Codex +1 128installs information-architecture information-architecture — a skill for organizing content so users find what they need. Guides through audits, card sorting, taxonomy design, navigation trees, and validation testing. CX Codex +1 127installs

Project sponsors

Companies that keep this analytics open