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
npx skills add lyndonkl/claude --skill cognitive-design -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/cognitive-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cognitive-design/
1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill cognitive-design -a codex2Manually: put the files in place
.agents/skills/cognitive-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill cognitive-design -a cursor2Manually: put the files in place
.cursor/skills/cognitive-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install lyndonkl/claude skills/cognitive-design2Manually: put the files in place
.github/skills/cognitive-design/SKILL.md1Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill cognitive-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/lyndonkl/claude --path skills/cognitive-designManually: put the files in place
.devin/skills/cognitive-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add lyndonkl/claude --skill cognitive-design -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.