running-design-reviews

Framework for running design reviews using feedback hierarchy and structured critique.

refoundai/lenny-skillsUpdated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGooseGitHub CopilotZed

0

total installs

0

this week

616

GitHub stars

0

upvotes

Install Skill

Run in your terminal

$npx skills add https://github.com/refoundai/lenny-skills --skill running-design-reviews

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

Category

Frontend

Last updated

Apr 8, 2026

Installation Guide

How to use running-design-reviews on Cursor

AI-first code editor with Composer

1

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
2

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/refoundai/lenny-skills --skill running-design-reviews

Fetches running-design-reviews from refoundai/lenny-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ────────────────
│ · Cline · Codex · Goose · Windsurf
│ ●Cursor(selected)
│ · Cursor · Aider · Continue
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/running-design-reviews

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:

  1. Understand the review context - Ask what stage the design is at and what kind of feedback is needed
  2. Establish the hierarchy - Help them prioritize feedback by value, then usability, then delight
  3. Structure the critique - Guide them on how to frame feedback constructively
  4. 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

Get started →

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

  1. 1Install skill using provided installation command
  2. 2Test with simple use case relevant to your work
  3. 3Evaluate output quality and relevance
  4. 4Iterate on prompts to improve results
  5. 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

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Related Skills

Reviews

4.668 reviews
  • C
    Camila DesaiDec 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.

  • W
    William HarrisDec 24, 2024

    running-design-reviews has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • A
    Aanya TaylorDec 20, 2024

    running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • N
    Noah KimDec 8, 2024

    running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • A
    Ava RaoDec 4, 2024

    running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • N
    Noor MensahDec 4, 2024

    Useful defaults in running-design-reviews — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • W
    William JacksonNov 27, 2024

    running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • W
    William MartinNov 23, 2024

    running-design-reviews is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • L
    Luis BrownNov 23, 2024

    I recommend running-design-reviews for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • D
    Dev ParkNov 11, 2024

    running-design-reviews reduced setup friction for our internal harness; good balance of opinion and flexibility.

showing 1-10 of 68

1 / 7

Discussion

Comments — not star reviews
  • No comments yet — start the thread.