{"id":"097a216f-f7fa-4847-b568-16897f7725bd","shortId":"5snzt6","kind":"skill","title":"running-design-reviews","tagline":"Run high-signal design reviews: brief, feedback log, decision record, follow-up plan.","description":"# Running Design Reviews\n\n## Scope\n\n**Covers**\n- Planning a design review with a clear decision and requested feedback type(s)\n- Running a live demo–centered critique (or async review when needed)\n- Capturing feedback without “design-by-committee”\n- Synthesizing feedback using **Value → Ease of Use → Delight** prioritization\n- Recording decisions, tradeoffs, and follow-ups so the review changes the work\n\n**When to use**\n- “Prepare and run a design critique for this Figma prototype.”\n- “We need a structured design review agenda and feedback log.”\n- “Help us review this flow and decide what to change before we ship.”\n- “Turn messy comments into prioritized feedback + next steps.”\n\n**When NOT to use**\n- You don’t have a defined problem, target user, or goal yet (use `problem-definition` first).\n- You need build-ready interaction specs / acceptance criteria (use `writing-specs-designs`).\n- You need evidence from users rather than expert critique -> use `usability-testing`.\n- You’re doing launch planning, comms, rollout/rollback (use `shipping-products`).\n- You need a general meeting facilitation framework, not a design-specific critique -> use `running-effective-meetings`.\n- You need to establish or audit design system components/tokens -> use `design-systems`.\n- You need to improve the design-to-engineering handoff process -> use `design-engineering`.\n\n## Inputs\n\n**Minimum required**\n- Design artifact(s): link(s) or screenshots (e.g., Figma/prototype) + what parts are in scope\n- The decision needed (what will change after the review)\n- Target user + job-to-be-done (1–2 sentences)\n- Success criteria (1–3) and constraints (time, platform, accessibility, tech)\n- Review format + logistics: live vs async, time box, attendees/roles\n\n**Missing-info strategy**\n- Ask up to **5** questions from [references/INTAKE.md](references/INTAKE.md), then proceed.\n- If answers aren’t available, make explicit assumptions and clearly label them.\n- Do not request secrets or credentials.\n\n## Outputs (deliverables)\n\nProduce a **Design Review Pack** in Markdown (in-chat by default; write to files if requested), in this order:\n1) **Design review brief / pre-read** (context, decision, requested feedback, links)\n2) **Agenda + facilitation script** (timed, prompts, roles)\n3) **Feedback log** (captured + categorized + prioritized)\n4) **Decision record** (decisions, tradeoffs, owners, due dates)\n5) **Follow-up message + next review plan** (what changed, what’s next)\n6) **Risks / Open questions / Next steps** (always included)\n\nTemplates: [references/TEMPLATES.md](references/TEMPLATES.md)\n\n## Workflow (7 steps)\n\n### 1) Classify the review and lock the decision\n- **Inputs:** Request + artifact(s) + constraints.\n- **Actions:** Identify the review type (concept / flow / content / visual polish / ship-readiness). Write the decision statement (“After this review we will decide ___”).\n- **Outputs:** Review type + decision statement + scope boundary (in/out).\n- **Checks:** Everyone can answer: “What will change after this review?”\n\n### 2) Set the requested feedback (and what NOT to comment on)\n- **Inputs:** Decision statement + stage of design.\n- **Actions:** Specify 1–3 feedback questions (e.g., “Is the value proposition clear?”, “Where does the flow break?”, “What edge cases are missing?”). Explicitly defer aesthetics/minutiae until Value/Ease are validated.\n- **Outputs:** Requested feedback list + “out of scope” feedback.\n- **Checks:** Feedback questions map directly to the decision.\n\n### 3) Assign roles (incl. a sponsor) and prepare a live demo\n- **Inputs:** Attendees list + timeline/risk.\n- **Actions:** Assign: **Presenter**, **Facilitator**, **Note-taker**, and a **Sponsor/DRI** (senior owner who focuses on “why” + core concept). Decide whether leadership must review all user-facing screens before ship (for high-craft products).\n- **Outputs:** Roles list + demo plan (what will be shown, in what order).\n- **Checks:** Decision rights are clear; the review is anchored in a live demo, not a slide deck.\n\n### 4) Produce the pre-read (context first, then artifacts)\n- **Inputs:** [references/TEMPLATES.md](references/TEMPLATES.md) (brief template) + project context.\n- **Actions:** Write a 1–2 page brief: problem → user → success criteria → constraints → options considered → risks/tradeoffs → open questions → links.\n- **Outputs:** Shareable pre-read + “how to review” instructions.\n- **Checks:** A reviewer can give useful feedback asynchronously without a live context dump.\n\n### 5) Run the review (big picture → Value → Ease → Delight)\n- **Inputs:** Agenda + demo + notes/feedback log.\n- **Actions:** Start with goals/feelings (“What’s bothering us overall?”), then evaluate:\n  1) **Value:** is it solving the right problem?\n  2) **Ease:** can users do it without friction?\n  3) **Delight:** polish, aesthetics, extra joy (only after 1–2)\n  Capture feedback as **observations + impact + suggestion**, not opinions.\n- **Outputs:** Filled feedback log with categories and severities.\n- **Checks:** The review does not get stuck in minutiae before Value/Ease are resolved.\n\n### 6) Synthesize + prioritize feedback into a change plan\n- **Inputs:** Feedback log.\n- **Actions:** Deduplicate comments; resolve conflicts by returning to goals and constraints; prioritize by user impact and risk. Convert top items into explicit changes with owners and due dates.\n- **Outputs:** Prioritized change list + updated feedback log status/owners.\n- **Checks:** Top 3 issues are clear; each has a proposed action and owner.\n\n### 7) Decide, document tradeoffs, and close the loop\n- **Inputs:** Proposed change plan + remaining open questions.\n- **Actions:** Record decisions and rationale; list tradeoffs and risks; define what must be re-reviewed. Send a follow-up summary and schedule the next review or ship gate.\n- **Outputs:** Decision record + follow-up message + Risks/Open questions/Next steps.\n- **Checks:** Decisions and action items are captured in writing; no critical decision is left implicit.\n\n## Quality gate (required)\n- Use [references/CHECKLISTS.md](references/CHECKLISTS.md) and score with [references/RUBRIC.md](references/RUBRIC.md).\n- Always include: **Risks**, **Open questions**, **Next steps**.\n\n## Examples\nSee [references/EXAMPLES.md](references/EXAMPLES.md).\n\n**Boundary example (redirect):** \"We want to test this prototype with 5 users and see where they get stuck.\"\nResponse: redirect to `usability-testing` -- this request needs user evidence from real participants, not expert critique in a design review.\n\n## Anti-patterns\n\nAvoid these common failure modes when running design reviews:\n\n1. **Design-by-committee** -- Treating every reviewer comment as a requirement. The facilitator must synthesize feedback through the Value > Ease > Delight hierarchy and let the DRI make final calls.\n2. **Minutiae-first critique** -- Spending the review debating icon styles, colors, or copy polish before validating that the design solves the right problem (Value) and is usable (Ease). Always enforce the hierarchy.\n3. **Missing decision statement** -- Running a review without stating what will change afterward. \"Get feedback\" is not a decision. Every review must start with \"After this review we will decide ___.\"\n4. **No pre-read, all context dump** -- Spending the first 15 minutes of a 30-minute review explaining context. Send a pre-read brief so reviewers arrive prepared and time is spent on critique.\n5. **Feedback without follow-through** -- Capturing feedback in a log but never converting it to action items with owners and due dates. The review is incomplete until a decision record and follow-up plan exist.\n\n## Reference files\n- [references/INTAKE.md](references/INTAKE.md)\n- [references/WORKFLOW.md](references/WORKFLOW.md)\n- [references/TEMPLATES.md](references/TEMPLATES.md)\n- [references/CHECKLISTS.md](references/CHECKLISTS.md)\n- [references/RUBRIC.md](references/RUBRIC.md)\n- [references/SOURCE_SUMMARY.md](references/SOURCE_SUMMARY.md)\n- [references/EXAMPLES.md](references/EXAMPLES.md)","tags":["running","design","reviews","lenny","skills","plus","liqiongyu","agent-skills","ai-agents","automation","claude","codex"],"capabilities":["skill","source-liqiongyu","skill-running-design-reviews","topic-agent-skills","topic-ai-agents","topic-automation","topic-claude","topic-codex","topic-prompt-engineering","topic-refoundai","topic-skillpack"],"categories":["lenny_skills_plus"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/liqiongyu/lenny_skills_plus/running-design-reviews","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add liqiongyu/lenny_skills_plus","source_repo":"https://github.com/liqiongyu/lenny_skills_plus","install_from":"skills.sh"}},"qualityScore":"0.474","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 49 github stars · SKILL.md body (8,052 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:56:24.858Z","embedding":null,"createdAt":"2026-04-18T22:17:00.246Z","updatedAt":"2026-04-22T00:56:24.858Z","lastSeenAt":"2026-04-22T00:56:24.858Z","tsv":"'1':260,265,336,396,469,611,673,697,931 '15':1035 '2':261,348,450,612,681,698,961 '3':266,355,470,512,689,777,994 '30':1039 '4':361,591,1024 '5':289,369,648,890,1060 '6':382,728 '7':394,788 'accept':150 'access':271 'action':409,467,527,608,662,739,785,803,846,1076 'aesthet':692 'aesthetics/minutiae':491 'afterward':1006 'agenda':97,349,658 'alway':388,869,990 'anchor':582 'answer':297,443 'anti':920 'anti-pattern':919 'aren':298 'arriv':1052 'artifact':231,406,600 'ask':286 'assign':513,528 'assumpt':303 'async':45,278 'asynchron':642 'attende':524 'attendees/roles':281 'audit':204 'avail':300 'avoid':922 'big':652 'bother':668 'boundari':438,880 'box':280 'break':483 'brief':11,339,604,614,1049 'build':146 'build-readi':145 'call':960 'captur':49,358,699,849,1066 'case':486 'categor':359 'categori':712 'center':42 'chang':75,110,249,378,446,734,761,769,798,1005 'chat':325 'check':440,504,574,635,715,775,843 'classifi':397 'clear':31,305,478,578,780 'close':793 'color':972 'comm':175 'comment':116,459,741,939 'committe':55,935 'common':924 'components/tokens':207 'concept':414,544 'conflict':743 'consid':621 'constraint':268,408,619,749 'content':416 'context':343,597,607,646,1030,1043 'convert':756,1073 'copi':974 'core':543 'cover':24 'craft':560 'credenti':313 'criteria':151,264,618 'critic':853 'critiqu':43,86,165,193,914,965,1059 'date':368,766,1082 'debat':969 'decid':107,431,545,789,1023 'decis':14,32,66,245,344,362,364,403,424,435,462,511,575,805,834,844,854,996,1012,1089 'deck':590 'dedupl':740 'default':327 'defer':490 'defin':131,812 'definit':141 'delight':63,656,690,952 'deliver':315 'demo':41,522,565,586,659 'design':3,9,21,27,53,85,95,156,191,205,210,218,225,230,318,337,466,917,929,933,980 'design-by-committe':52,932 'design-engin':224 'design-specif':190 'design-system':209 'design-to-engin':217 'direct':508 'document':790 'done':259 'dri':957 'due':367,765,1081 'dump':647,1031 'e.g':237,473 'eas':60,655,682,951,989 'edg':485 'effect':197 'enforc':991 'engin':220,226 'establish':202 'evalu':672 'everi':937,1013 'everyon':441 'evid':159,908 'exampl':876,881 'exist':1096 'expert':164,913 'explain':1042 'explicit':302,489,760 'extra':693 'face':553 'facilit':186,350,530,944 'failur':925 'feedback':12,35,50,57,99,119,346,356,454,471,498,503,505,641,700,709,731,737,772,947,1008,1061,1067 'figma':89 'figma/prototype':238 'file':330,1098 'fill':708 'final':959 'first':142,598,964,1034 'flow':105,415,482 'focus':540 'follow':17,70,371,822,837,1064,1093 'follow-through':1063 'follow-up':16,69,370,821,836,1092 'format':274 'framework':187 'friction':688 'gate':832,859 'general':184 'get':720,896,1007 'give':639 'goal':136,747 'goals/feelings':665 'handoff':221 'help':101 'hierarchi':953,993 'high':7,559 'high-craft':558 'high-sign':6 'icon':970 'identifi':410 'impact':703,753 'implicit':857 'improv':215 'in-chat':323 'in/out':439 'incl':515 'includ':389,870 'incomplet':1086 'info':284 'input':227,404,461,523,601,657,736,796 'instruct':634 'interact':148 'issu':778 'item':758,847,1077 'job':256 'job-to-be-don':255 'joy':694 'label':306 'launch':173 'leadership':547 'left':856 'let':955 'link':233,347,625 'list':499,525,564,770,808 'live':40,276,521,585,645 'lock':401 'log':13,100,357,661,710,738,773,1070 'logist':275 'loop':795 'make':301,958 'map':507 'markdown':322 'meet':185,198 'messag':373,839 'messi':115 'minimum':228 'minut':1036,1040 'minutia':723,963 'minutiae-first':962 'miss':283,488,995 'missing-info':282 'mode':926 'must':548,814,945,1015 'need':48,92,144,158,182,200,213,246,906 'never':1072 'next':120,374,381,386,828,874 'note':532 'note-tak':531 'notes/feedback':660 'observ':702 'open':384,623,801,872 'opinion':706 'option':620 'order':335,573 'output':314,432,496,562,626,707,767,833 'overal':670 'owner':366,538,763,787,1079 'pack':320 'page':613 'part':240 'particip':911 'pattern':921 'pictur':653 'plan':19,25,174,376,566,735,799,1095 'platform':270 'polish':418,691,975 'pre':341,595,629,1027,1047 'pre-read':340,594,628,1026,1046 'prepar':81,519,1053 'present':529 'priorit':64,118,360,730,750,768 'problem':132,140,615,680,984 'problem-definit':139 'proceed':295 'process':222 'produc':316,592 'product':180,561 'project':606 'prompt':353 'propos':784,797 'proposit':477 'prototyp':90,888 'qualiti':858 'question':290,385,472,506,624,802,873 'questions/next':841 'rather':162 'rational':807 're':171,817 're-review':816 'read':342,596,630,1028,1048 'readi':147,421 'real':910 'record':15,65,363,804,835,1090 'redirect':882,899 'refer':1097 'references/checklists.md':862,863,1105,1106 'references/examples.md':878,879,1111,1112 'references/intake.md':292,293,1099,1100 'references/rubric.md':867,868,1107,1108 'references/source_summary.md':1109,1110 'references/templates.md':391,392,602,603,1103,1104 'references/workflow.md':1101,1102 'remain':800 'request':34,310,332,345,405,453,497,905 'requir':229,860,942 'resolv':727,742 'respons':898 'return':745 'review':4,10,22,28,46,74,96,103,252,273,319,338,375,399,412,428,433,449,549,580,633,637,651,717,818,829,918,930,938,968,1000,1014,1020,1041,1051,1084 'right':576,679,983 'risk':383,755,811,871 'risks/open':840 'risks/tradeoffs':622 'role':354,514,563 'rollout/rollback':176 'run':2,5,20,38,83,196,649,928,998 'running-design-review':1 'running-effective-meet':195 'schedul':826 'scope':23,243,437,502 'score':865 'screen':554 'screenshot':236 'script':351 'secret':311 'see':877,893 'send':819,1044 'senior':537 'sentenc':262 'set':451 'sever':714 'shareabl':627 'ship':113,179,420,556,831 'ship-readi':419 'shipping-product':178 'shown':570 'signal':8 'skill' 'skill-running-design-reviews' 'slide':589 'solv':677,981 'source-liqiongyu' 'spec':149,155 'specif':192 'specifi':468 'spend':966,1032 'spent':1057 'sponsor':517 'sponsor/dri':536 'stage':464 'start':663,1016 'state':1002 'statement':425,436,463,997 'status/owners':774 'step':121,387,395,842,875 'strategi':285 'structur':94 'stuck':721,897 'style':971 'success':263,617 'suggest':704 'summari':824 'synthes':56,729,946 'system':206,211 'taker':533 'target':133,253 'tech':272 'templat':390,605 'test':169,886,903 'time':269,279,352,1055 'timeline/risk':526 'top':757,776 'topic-agent-skills' 'topic-ai-agents' 'topic-automation' 'topic-claude' 'topic-codex' 'topic-prompt-engineering' 'topic-refoundai' 'topic-skillpack' 'tradeoff':67,365,791,809 'treat':936 'turn':114 'type':36,413,434 'up':71 'updat':771 'us':102,669 'usability-test':167,901 'usabl':168,902,988 'use':58,62,80,125,138,152,166,177,194,208,223,640,861 'user':134,161,254,552,616,684,752,891,907 'user-fac':551 'valid':495,977 'valu':59,476,654,674,950,985 'value/ease':493,725 'visual':417 'vs':277 'want':884 'whether':546 'without':51,643,687,1001,1062 'work':77 'workflow':393 'write':154,328,422,609,851 'writing-specs-design':153 'yet':137","prices":[{"id":"50438fa9-3bd5-43c8-8caa-904b20f07c57","listingId":"097a216f-f7fa-4847-b568-16897f7725bd","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"liqiongyu","category":"lenny_skills_plus","install_from":"skills.sh"},"createdAt":"2026-04-18T22:17:00.246Z"}],"sources":[{"listingId":"097a216f-f7fa-4847-b568-16897f7725bd","source":"github","sourceId":"liqiongyu/lenny_skills_plus/running-design-reviews","sourceUrl":"https://github.com/liqiongyu/lenny_skills_plus/tree/main/skills/running-design-reviews","isPrimary":false,"firstSeenAt":"2026-04-18T22:17:00.246Z","lastSeenAt":"2026-04-22T00:56:24.858Z"}],"details":{"listingId":"097a216f-f7fa-4847-b568-16897f7725bd","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"liqiongyu","slug":"running-design-reviews","github":{"repo":"liqiongyu/lenny_skills_plus","stars":49,"topics":["agent-skills","ai-agents","automation","claude","codex","prompt-engineering","refoundai","skillpack"],"license":"apache-2.0","html_url":"https://github.com/liqiongyu/lenny_skills_plus","pushed_at":"2026-04-04T06:30:11Z","description":"86 agent-executable skill packs converted from RefoundAI’s Lenny skills (unofficial). Works with Codex + Claude Code.","skill_md_sha":"c08c367dee968b81da66b83e04daf2e548675571","skill_md_path":"skills/running-design-reviews/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/liqiongyu/lenny_skills_plus/tree/main/skills/running-design-reviews"},"layout":"multi","source":"github","category":"lenny_skills_plus","frontmatter":{"name":"running-design-reviews","description":"Run high-signal design reviews: brief, feedback log, decision record, follow-up plan."},"skills_sh_url":"https://skills.sh/liqiongyu/lenny_skills_plus/running-design-reviews"},"updatedAt":"2026-04-22T00:56:24.858Z"}}