running-design-reviews
Framework for running design reviews using feedback hierarchy and structured critique.
Works with
0
total installs
0
this week
616
GitHub stars
0
upvotes
Install Skill
Run in your terminal
0
installs
0
this week
616
stars
What it does
Prioritize feedback by value first (does it solve the problem?), then usability, then delight; defer aesthetic concerns until core value is validated
Assign senior leaders as project sponsors to oversee quality through live demos and review 100% of shipped screens before launch
Structure reviews around specific feedback requests; ask presenters exactly what type of input they need rather than openi
Installation Guide
How to use running-design-reviews on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your machine
- ›Node.js 16+ with npm — verify with
node --version - ›Active project directory where you want to add
running-design-reviews
Run the install command
Execute the skills CLI command in your project's root directory to begin installation:
Fetches running-design-reviews from refoundai/lenny-skills and configures it for Cursor.
Select Cursor when prompted
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate running-design-reviews. Access via /running-design-reviews in your agent's command palette.
Security Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Documentation
Running Design Reviews
Help the user run effective design reviews and critiques using frameworks from 8 product leaders.
How to Help
When the user asks for help with design reviews:
- Understand the review context - Ask what stage the design is at and what kind of feedback is needed
- Establish the hierarchy - Help them prioritize feedback by value, then usability, then delight
- Structure the critique - Guide them on how to frame feedback constructively
- Set the quality bar - Help them define what "good enough to ship" means
Core Principles
Follow the feedback hierarchy: Value, then Ease of Use, then Delight
Julie Zhuo: "The first thing that's most important to address is, well, is this thing actually valuable, is this solving the problem? Then once we do that, then let's focus on the next layer which I think about as ease of use... And then finally... delight." Disregard feedback about aesthetics until the core value proposition is validated.
Assign sponsors for major projects
Karri Saarinen: "We are basically the sponsors for the projects. So then we are responsible reviewing the work. And so we might just have a meeting where we go through, okay..." Assign a founder or senior leader as a sponsor for every major project to oversee quality through live demos rather than static slide decks.
Review 100% of shipped screens
Dmitry Zlokazov: "Founders of the company, they still review a hundred percent of screens that are being shipped and everything that you will see in the app pass this review." Maintain a high quality bar by having senior leaders review every user-facing screen before shipping.
Structure reviews around specific feedback requests
Geoff Charles: "Any large rock that we have on the roadmap needs to be brought into the product review process... but it needs to be structured in a way where you are asking specifically for what type of feedback you want." Only bring high-risk decisions to formal reviews and require presenters to specify exactly what feedback they need.
Start big picture before minutiae
Jessica Hische: "Always think big picture before you think minutiae, because sometimes people think that... They'll throw a bunch of minutiae stuff at me, but it's because they don't know what's really bugging them." Ask "What is the overall thing that's bothering me?" before commenting on specific elements.
Use blurred vision to see cohesiveness
Jessica Hische: "Use 'blurred eyes' to look at a brand's overall cohesiveness rather than focusing on individual pixels." Step back from details to assess whether the overall design holds together.
Questions to Help Users
- "What specific type of feedback are you looking for in this review?"
- "Is the core value proposition clear? Does this solve the right problem?"
- "Before we discuss details - what's the overall feeling when you first look at this?"
- "What are the highest-risk elements of this design that need the most scrutiny?"
- "What would make this not shippable? Are we close to that line?"
- "If a user sees this for three seconds, what will they understand?"
Common Mistakes to Flag
- Feedback without hierarchy - Mixing aesthetic opinions with core value concerns
- Static reviews - Reviewing slide decks instead of interactive demos
- Unstructured feedback requests - Not specifying what kind of feedback is needed
- Skipping to details - Critiquing pixels before validating the concept
- No quality bar - Shipping without senior review or clear standards
Deep Dive
For all 10 insights from 8 guests, see references/guest-insights.md
Related Skills
- product-taste-intuition
- running-effective-meetings
- scoping-cutting
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases
Task Automation & Efficiency
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Knowledge Enhancement
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Quality Improvement
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
Implementation Guide
Prerequisites
- ›Claude Desktop or compatible AI client with skill support
- ›Clear understanding of task or problem to solve
- ›Willingness to iterate and refine outputs
Time Estimate
15-45 minutes depending on use case complexity
Steps
- 1Install skill using provided installation command
- 2Test with simple use case relevant to your work
- 3Evaluate output quality and relevance
- 4Iterate on prompts to improve results
- 5Integrate into regular workflow if valuable
Common Pitfalls
- ⚠Expecting perfect results without iteration
- ⚠Not providing enough context in prompts
- ⚠Using skill for tasks outside its intended scope
- ⚠Accepting outputs without review and validation
Best Practices
✓ Do
- +Start with clear, specific prompts
- +Provide relevant context and constraints
- +Review and refine all outputs before using
- +Iterate to improve output quality
- +Document successful prompt patterns
✗ Don't
- −Don't use without understanding skill limitations
- −Don't skip validation of outputs
- −Don't share sensitive information in prompts
- −Don't expect skill to replace human judgment
💡 Pro Tips
- ★Be specific about desired format and style
- ★Ask for multiple options to choose from
- ★Request explanations to understand reasoning
- ★Combine AI efficiency with human expertise
When to Use This
✓ Use when
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid when
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
Learning Path
- 1Familiarize yourself with skill capabilities and limitations
- 2Start with low-risk, non-critical tasks
- 3Progress to more complex and valuable use cases
- 4Build expertise through regular use and experimentation
Related Skills
frontend-design
457anthropics/claude-code
high-end-visual-design
141leonxlnx/taste-skill
antigravity-design-expert
88sickn33/antigravity-awesome-skills
interior-design-expert
80erichowens/some_claude_skills
tui-design
61hyperb1iss/hyperskills
design-motion-principles
47kylezantos/design-motion-principles
Reviews
- CCamila Desai★★★★★Dec 24, 2024
Keeps context tight: running-design-reviews is the kind of skill you can hand to a new teammate without a long onboarding doc.
- WWilliam Harris★★★★★Dec 24, 2024
running-design-reviews has been reliable in day-to-day use. Documentation quality is above average for community skills.
- AAanya Taylor★★★★★Dec 20, 2024
running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- NNoah Kim★★★★★Dec 8, 2024
running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- AAva Rao★★★★★Dec 4, 2024
running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.
- NNoor Mensah★★★★★Dec 4, 2024
Useful defaults in running-design-reviews — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- WWilliam Jackson★★★★★Nov 27, 2024
running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.
- WWilliam Martin★★★★★Nov 23, 2024
running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- LLuis Brown★★★★★Nov 23, 2024
I recommend running-design-reviews for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- DDev Park★★★★★Nov 11, 2024
running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.
showing 1-10 of 68
Discussion
Comments — not star reviews- No comments yet — start the thread.