lyndonkl/cognitive-design
skills/cognitive-design/SKILL.md
Grounds visual design decisions in cognitive psychology principles — perception, attention, memory, Gestalt grouping, and visual encoding hierarchy — explaining WHY certain designs work. Covers interfaces, data visualizations, educational content, and presentations. Invoke when user mentions cognitive load, visual hierarchy, working memory, preattentive processing, Gestalt principles, encoding hierarchy, or cognitive design pyramid. For design evaluation, use `design-evaluation-audit`. For fallacy prevention, use `cognitive-fallacies-guard`. For data storytelling, use `visual-storytelling-design`.
$ install --global
skillsauthnpx skillsauth add lyndonkl/claude cognitive-designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 6:26 AM10.9s9 files scanned
SKILL.md
- name:
- cognitive-design
- description:
- Grounds visual design decisions in cognitive psychology principles — perception, attention, memory, Gestalt grouping, and visual encoding hierarchy — explaining WHY certain designs work. Covers interfaces, data visualizations, educational content, and presentations. Invoke when user mentions cognitive load, visual hierarchy, working memory, preattentive processing, Gestalt principles, encoding hierarchy, or cognitive design pyramid. For design evaluation, use `design-evaluation-audit`. For fallacy prevention, use `cognitive-fallacies-guard`. For data storytelling, use `visual-storytelling-design`.
Cognitive Design Principles
Table of Contents
- Overview
- Workflows
- Apply Cognitive Principles Workflow
- Quick Validation Workflow
- Path Selection Menu
- Path 1: Understand Cognitive Foundations
- Path 2: Apply Design Frameworks
- Path 3: Get Domain-Specific Guidance
- Path 4: Access Quick Reference
- Path 5: Explore Source Landscape
- Path 6: Exit
- Related Skills
Overview
This skill provides the cognitive science foundations for effective design — the perception, attention, memory, and decision-making principles that explain WHY certain designs work. It helps ground design decisions in research (Tufte, Norman, Ware, Cleveland & McGill, Mayer), apply systematic frameworks (Cognitive Design Pyramid, Design Feedback Loop, Three-Layer Model), choose appropriate visual encodings, and manage attention, memory limits, and cognitive load.
Related skills: design-evaluation-audit for systematic reviews, cognitive-fallacies-guard for detecting misleads, visual-storytelling-design for data journalism, information-architecture for content organization, d3-visualization for D3.js implementation.
Workflows
Apply Cognitive Principles Workflow
Use when: Creating a new interface, dashboard, visualization, or educational content from scratch
Time: 1-2 hours
Copy this checklist and track your progress:
Cognitive Design Progress:
- [ ] Step 1: Orient to cognitive principles
- [ ] Step 2: Structure design thinking with frameworks
- [ ] Step 3: Apply domain-specific guidance
- [ ] Step 4: Validate against quick reference
Step 1: Orient to cognitive principles
Start with Cognitive Foundations for deep understanding of WHY designs work (perception, memory, Gestalt principles) OR use Quick Reference for rapid orientation (20 core principles, decision rules). Foundations give you theoretical grounding; Quick Reference gets you started faster.
Step 2: Structure design thinking with frameworks
Use Design Frameworks to apply systematic approaches: Cognitive Design Pyramid (4-tier quality assessment), Design Feedback Loop (interaction cycles), and Three-Layer Visualization Model (data communication fidelity). These provide repeatable structure for design decisions.
Step 3: Apply domain-specific guidance
Choose your domain: Data Visualization for charts/dashboards, UX Product Design for interfaces/apps, or Educational Design for e-learning/training. Apply tailored cognitive principles for your specific context.
Step 4: Validate against quick reference
Use Quick Reference to verify your design against the 3-question check (Attention? Memory? Clarity?) and 20 core principles. Confirm your design passes basic cognitive alignment.
Next steps: Use design-evaluation-audit skill for systematic evaluation, cognitive-fallacies-guard to check for misleads.
Quick Validation Workflow
Use when: Need rapid go/no-go decision, spot-checking changes, or validating against cognitive basics during active design work
Time: 5-10 minutes
Copy this checklist and track your progress:
Quick Validation Progress:
- [ ] Step 1: Three-question rapid check
- [ ] Step 2: Spot checks if issues found
Step 1: Three-question rapid check
Use Quick Reference and apply: (1) Attention - "Is it obvious what to look at first?" (visual hierarchy clear, primary elements salient, predictable scanning), (2) Memory - "Is user required to remember anything that could be shown?" (state visible, options presented, fits 4±1 chunks), (3) Clarity - "Can someone unfamiliar understand in 5 seconds?" (purpose graspable, no unnecessary decoration, familiar terminology). If all YES → likely cognitively sound.
Step 2: Spot checks if issues found
If any question fails, consult the relevant cognitive foundation: Failed attention? Check hierarchy and visual salience in Cognitive Foundations. Failed memory? Check chunking and memory constraints. Failed clarity? Check simplicity principles and labeling guidance.
Path Selection Menu
Choose your path based on current need:
Path 1: Understand Cognitive Foundations
Choose this when: You want to learn the core cognitive psychology principles underlying effective design (attention, memory, perception, Gestalt grouping, visual encoding hierarchy).
What you'll get: Deep understanding of WHY certain designs work, grounded in research.
Time: 20-40 minutes
→ Go to Cognitive Foundations resource
Path 2: Apply Design Frameworks
Choose this when: You want systematic frameworks to structure your design thinking.
What you'll get: Three complementary frameworks:
- Cognitive Design Pyramid (4 tiers: Perceptual Efficiency → Cognitive Coherence → Emotional Engagement → Behavioral Alignment)
- Design Feedback Loop (Perceive → Interpret → Decide → Act → Learn)
- Three-Layer Visualization Model (Data → Visual Encoding → Cognitive Interpretation)
Time: 30-45 minutes
→ Go to Frameworks resource
Path 3: Get Domain-Specific Guidance
Choose this when: You're working on a specific type of design and want tailored cognitive principles.
Choose your domain:
3a. Data Visualization (Charts, Dashboards, Analytics)
→ Go to Data Visualization resource
Covers: Chart selection via task-encoding alignment, dashboard hierarchy and grouping, progressive disclosure for exploration, narrative data visualization
3b. Product/UX Design (Interfaces, Mobile Apps, Web Applications)
→ Go to UX Product Design resource
Covers: Learnability via familiar patterns, task flow efficiency, cognitive load management, onboarding design, error handling
3c. Educational Design (E-Learning, Training, Instructional Materials)
→ Go to Educational Design resource
Covers: Multimedia learning principles, dual coding, worked examples, retrieval practice, segmenting, coherence principle
Path 4: Access Quick Reference
Choose this when: You need rapid design guidance, core principles summary, or quick validation checks.
What you'll get: 20 core principles, 3-question check, common decision rules, design heuristics
Time: 5-15 minutes
→ Go to Quick Reference resource
Path 5: Explore Source Landscape
Choose this when: You want to understand the research traditions and key authors behind cognitive design principles.
What you'll get: Key researchers (Tufte, Norman, Ware, Cleveland & McGill, Mayer, Nielsen), their contributions, and when to cite them.
Time: 10-20 minutes
→ Go to Source Landscape resource
Path 6: Exit
Choose this when: You've completed your design work or gathered the information you need.
Before you exit:
- Have you achieved your goal for this session?
- Need to evaluate your design? → Use
design-evaluation-auditskill - Need to check for misleads? → Use
cognitive-fallacies-guardskill - Need to tell a data story? → Use
visual-storytelling-designskill
Related Skills
| Skill | Use For |
|---|---|
| design-evaluation-audit | Systematic design reviews using cognitive checklists and visualization audits |
| cognitive-fallacies-guard | Detecting chartjunk, misleading axes, cognitive biases, data integrity violations |
| visual-storytelling-design | Data journalism, presentations, infographics, narrative visualization |
| information-architecture | Content organization, navigation design, taxonomy, findability |
| d3-visualization | Implementing interactive data visualizations with D3.js |
Related Skills
lyndonkl/skills/advisory-edit
testing
VerifiedTrustedCommunity
--- name: advisory-edit description: A strict advisory-only editing discipline for a writer who dictates ("speaks out") essays and wants help WITHOUT having their voice changed. The editor directs structure, flags grammar, and suggests strategic language — but never modifies the writer's text unless the writer explicitly says "apply" / "make that change" / "rewrite this." Produces a line-referenced, suggestion-only critique where every item is marked the writer's call. Four passes: structural, l
112SKILL.mdUpdated Jun 3, 2026
lyndonkl/strategist-voice
testing
VerifiedTrustedCommunity
Provides the house style for analyst-grade strategist writing — third-person register with sparing first-person, no em dashes, no "not X, not Y, not Z" negation cascades, numbered footnote citations rather than inline source parentheticals, specific opinion-signaling phrases, and topic-forward paragraph structure modeled on voice patterns observed in Damodaran's Musings on Markets and Thompson's Stratechery. Use when consolidating working notes into a finished long-form strategist or analyst report that must read as written by a senior human analyst rather than an AI assistant.
98SKILL.mdUpdated May 17, 2026
lyndonkl/markdown-to-pdf
testing
VerifiedTrustedCommunity
Renders a markdown report to a PDF using pandoc with xelatex (11pt serif body, 1-inch margins, numbered footnotes, formal heading hierarchy). Requires a one-time install of pandoc and a LaTeX engine on the user's machine — basictex on macOS or texlive-xetex on Linux. Does not attempt automatic install. Fails loudly with the exact install commands if pandoc or xelatex is missing on the user's PATH. Use when producing a finished strategist or analyst report PDF from a polished markdown source.
98SKILL.mdUpdated May 17, 2026
lyndonkl/worked-example-walkthrough
testing
VerifiedTrustedCommunity
Produces step-by-step computational walkthroughs of vector and matrix operations as a sequence of numbered "frames", showing the explicit state at each step. The text-equivalent of a 3Blue1Brown animation — each frame shows what changed and why, so the learner can re-trace the operation by hand. Use when the learner needs to *see* a computation unfold (eigenvalue computation, attention with 3 tokens, gradient descent step, SVD on a 2×2, layer norm on a 3-vector, softmax of a small input), when an explanation has been given but the learner needs to ground it in a worked example, or when introducing an operation that's intimidating in symbol form but trivial in pencil-and-paper form.
94SKILL.mdUpdated May 10, 2026