plugins/pm-design/skills/design-critique/SKILL.md
Give structured, constructive feedback on any design. Use when asked to critique a design, review a UI, give feedback on a Figma file or wireframe, assess a user flow, or evaluate a design against UX principles. Applies Jobs-to-be-Done, Gestalt principles, and usability heuristics to give actionable feedback.
npx skillsauth add mohitagw15856/pm-claude-skills design-critiqueInstall 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.
This skill provides structured, actionable design feedback using established UX frameworks. It balances positive observations with clear, prioritised improvement suggestions.
Ask the user for these if not provided:
User goal: [What the user needs to accomplish] Context: [Platform / Stage] Critique focus: [Primary concern if stated, otherwise "full review"]
[3–5 specific, honest observations about what the design does well. Don't manufacture praise — only include genuine strengths. Be specific: "The visual hierarchy clearly guides the eye from headline → supporting detail → CTA" is useful. "Looks clean" is not.]
Rank issues by impact on the user goal. Use:
For each issue:
What's happening: [Describe the specific design problem — be precise about which element, screen, or interaction]
Why it matters: [Connect to the user goal or a specific principle — don't just say "it's confusing." Say why it creates confusion and what the consequence is for the user.]
Framework reference: [Name the principle being violated — e.g. Nielsen's Heuristic #6 (Recognition over Recall), Gestalt proximity, JTBD clarity, Fitts's Law, etc.]
Recommendation: [Specific, actionable suggestion. Not "make the button bigger" but "Increase the primary CTA to at least 44x44px to meet touch target guidelines; consider moving it below the form rather than inline with the input fields to reduce accidental taps."]
Quick assessment against Nielsen's 10 Usability Heuristics — score each as ✅ Pass / 🟡 Partial / ❌ Fail:
| Heuristic | Status | Note | |---|---|---| | 1. Visibility of system status | | | | 2. Match between system and real world | | | | 3. User control and freedom | | | | 4. Consistency and standards | | | | 5. Error prevention | | | | 6. Recognition rather than recall | | | | 7. Flexibility and efficiency of use | | | | 8. Aesthetic and minimalist design | | | | 9. Help users recognise, diagnose, and recover from errors | | | | 10. Help and documentation | | |
Only include heuristics relevant to what's visible in the design — don't penalise for things not in scope.
[Comment on any Gestalt principles that are either well-applied or violated:]
[Assess how well the design serves the stated job-to-be-done:]
Prioritised list of the 3 most impactful changes. Each should be actionable in the next design iteration:
development
Build a framework for creating shareable, high-reach social media content. Use when asked to plan viral content, develop a shareable content strategy, create a hook writing system, or build a repeatable process for content that gets shared. Produces a platform-specific viral content framework with hook formulas, content structures, shareability triggers, and a content testing system.
development
Generate article or newsletter thumbnail candidates using the Gemini API from inside Claude Code. Claude reads article copy, proposes composition concepts, writes image generation prompts incorporating brand specs, calls Gemini to generate the images, evaluates the results via computer vision, and returns ranked candidates with rationale. Use when asked to create thumbnails, generate cover images, or produce visual candidates for an article or newsletter.
testing
Flips Claude's default from "find reasons you're right" to "find reasons you're wrong." A genuine thinking partner, not a mirror with grammar. Use before high-stakes decisions, plans, assumptions, or pitches you haven't stress-tested.
development
Scrapes a Substack Notes page and exports engagement data (likes, comments, restacks) to a formatted .xlsx file with conditional formatting and summary stats.