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.