# Design Review

> ---

- Skill: `itsimonfredlingjack-codex-dev-plugin/design-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add itsimonfredlingjack-codex-dev-plugin/design-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/itsimonfredlingjack-codex-dev-plugin/design-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: itsimonfredlingjack (https://skillmd.com/u/itsimonfredlingjack-codex-dev-plugin)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/itsimonfredlingjack-codex-dev-plugin/design-review

---

---
name: design-review
description: "Review existing UI for issues and improvements"
---
## Major Issues

### Issue 2: {Title}

...

## Minor Issues

### Issue 3: {Title}

...

## Suggestions

### Suggestion 1: {Title}

...

## Positive Observations

{List things done well to reinforce good patterns}

- {Positive observation 1}
- {Positive observation 2}

## Next Steps

1. {Prioritized action 1}
2. {Prioritized action 2}
3. {Prioritized action 3}

---

_Generated by UI Design Review. Run `/ui-design:design-review` again after fixes._

```

## Completion

After generating report:

1. Update `review_state.json`:
   - Set `status: "complete"`
   - Update issue counts

2. Display summary:

```

Design Review Complete!

Target: {component/file}
Issues Found: {total}

- {critical} Critical
- {major} Major
- {minor} Minor
- {suggestions} Suggestions

Full report: .ui-design/reviews/{review_id}.md

What would you like to do next?

1. View detailed findings for a specific issue
2. Start implementing fixes
3. Export report (markdown/JSON)
4. Review another component

```

## Follow-up Actions

If user selects "Start implementing fixes":

```

Which issues would you like to address?

1. All critical issues first
2. All issues in current file
3. Specific issue (enter number)
4. Generate a fix plan for all issues

Enter choice:

```

Guide user through fixes one at a time, updating the review report as issues are resolved.

## Error Handling

- If target file not found: Suggest similar files, offer to search
- If file is not UI code: Explain and ask for correct target
- If review fails mid-way: Save partial results, offer to resume
```

## Output Format

```xml
<result>
  <analysis>Brief analysis</analysis>
  <solution>Implementation</solution>
  <considerations>Trade-offs and notes</considerations>
</result>
```