.claude/skills/comprehension-first-design/SKILL.md
A product design framework focused on reducing cognitive load (glucose/ATP expenditure) rather than just clicks. Use this when designing onboarding, introducing complex features, or auditing a UI where users drop off due to confusion rather than effort.
npx skillsauth add samarv/Shanon comprehension-first-designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Product design is often mistakenly focused on reducing "friction" (the number of clicks or taps). However, for most unique products, the real barrier isn't effort—it's comprehension. If a user has to stop and think because they don't understand an option, they feel "stupid," creating an emotional debt that leads to churn.
Recognize that as a creator, you are "delusional" about the user's level of intent.
Every decision costs biological energy (glucose/ATP).
Features are not binary; they exist on an S-curve.
Sometimes, adding a step improves the experience by shaping behavior or preventing regret.
If you don't set a default, most users will never use the feature.
Avoid "Choice Paralysis" by hiding complexity.
Context: A user downloads a mobile app and needs to sign in. Input: Traditional Username/Password fields. Application: Apply "Don't Make Me Think." Typing a complex password on a phone is high friction and high cognitive load. Output: Use a Magic Link. The user enters an email, clicks a link in their inbox, and the app automatically authenticates. It replaces "remembering/typing" with "clicking a button."
Context: A user needs to set an event time in a different time zone. Input: An alphabetical list of all 400+ global time zones. Application: Combat the "Owner's Delusion." Most users only care about 10-12 major zones. Output: Prioritize the 5 most likely zones based on the user's current location and past behavior (e.g., if in SF, show Pacific, Eastern, and London first). Use a sub-menu or search for the "long tail" (e.g., Newfoundland).
documentation
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
development
A framework to identify and develop sustainable competitive advantages (Power) based on a company's lifecycle stage. Use this when drafting a product strategy, evaluating business model durability, or distinguishing between "operational excellence" and true competitive moats.
development
```yaml --- name: podcast-launch-and-growth-engine description: A framework for launching and scaling a podcast based on topic validation, ranking momentum, and lean production. Use this skill when starting a new content channel, choosing a niche, or designing a listener acquisition strategy. --- This framework leverages Chris Hutchins' "All the Hacks" methodology to move from an idea to the top 5% of active podcasts through strategic validation, momentum-based launching, and high-efficiency di
development
A high-bar framework for measuring and achieving product-market fit (PMF) before scaling. Use this when validating a new product line, deciding if a beta is ready for a general release, or diagnosing why a product isn't generating organic word-of-mouth growth.