design-review

Analyze SwiftUI view files for visual hierarchy, color, spacing, and token issues.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill design-review-n0rvyn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/apple-dev/skills/design-review
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill design-review-n0rvyn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide a systematic, code-driven visual design review for SwiftUI-based app screens to catch weak visual hierarchy, conflicting color emphasis, inconsistent spacing, token misuse, and macOS-specific layout issues before visual optimization or release.

Core Features & Use Cases

  • Code-verified checks: Automated analysis of SwiftUI modifiers to validate font hierarchy, color strategy, spacing rhythm, alignment, card/container rules, icon consistency, navigation depth, and interaction feedback with file:line references.
  • Reference-driven: Loads project references such as ui-design-principles.md and apple-ui-checklist.md to enforce project-specific thresholds and platform-specific rules.
  • Cross-file comparison & reports: Compares similarly named components across files for consistent tokens and produces a Design Review Report with prioritized 🔴/🟡 findings and a device validation checklist for manual visual checks.
  • Safe workflow: Complements /ui-review and /feature-review, recommends fixes but requires explicit user confirmation before any code modification.
  • Use cases: Run after completing a page/module UI, before visual polishing, during pre-release QA, or as part of a design handoff.

Quick Start

Run a design review on the changed SwiftUI view files and produce a code-referenced report that highlights visual hierarchy, color strategy, spacing, and design-token issues.

Frequently Asked Questions about design-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit SwiftUI visual hierarchy and spacing rhythm in my source files?▼

Audit SwiftUI visual hierarchy by parsing view files for font, padding, and frame modifiers to detect inconsistent spacing rhythm and produce file:line references for visual optimization.

What is a code-driven design review for SwiftUI and how does it work?▼

A code-driven design review analyzes SwiftUI source files to validate color strategy, token usage, and navigation constructs against project references, generating a prioritized report with device verification checklists.

Can I check SwiftUI design token usage and macOS layout problems before release?▼

Check SwiftUI design token usage and macOS layout problems by scanning completed module UI files to identify token misuse and platform-specific layout issues before pre-release QA.

How do I generate a SwiftUI UI audit report with prioritized findings?▼

Generate a SwiftUI UI audit report by scanning changed view files to compare component tokens, producing prioritized red and yellow findings with file:line references and a manual device validation checklist.

Does the SwiftUI design review require specific reference documents?▼

The SwiftUI design review requires project Swift source files and reference documents like ui-design-principles.md and apple-ui-checklist.md to enforce project-specific thresholds and platform-specific rules during analysis.

When should I run a visual design review on my iOS or macOS app?▼

Run a visual design review after completing a page or module UI, before visual polishing, during pre-release QA, or as part of a design handoff to catch weak hierarchy and conflicting color emphasis.