Sandbox
@Wholiver/swiftui-design-skill

SwiftUI design skill pack for agent builders

This skill adds a design workflow for SwiftUI interfaces: direction setting, brand asset handling, layout patterns, and review rules. It combines anti-slop checks, design-school variants, and a 5-dimension review so the agent can produce and critique interface work in one place.

190 stars9 forksUpdated 4mo ago
Who it's for

Builders who use agent tools to design SwiftUI and iOS interfaces with a clearer visual style.

What it delivers

You can get SwiftUI screens that feel more designed and less like generic AI output.

What it does

Anti-AI slop rules

Defines six checks that push the agent to start from context, show variants, and avoid common visual clichés.

Design direction advisor

Suggests three directions from five design schools when the brief is vague, with style references for each.

Brand asset protocol

Walks through asking for brand guidelines, finding official assets, verifying colors, and writing `brand-spec.md`.

Five-dimension review

Scores philosophy, hierarchy, detail, functionality, and originality before delivery.

Layout pattern library

Provides nine common SwiftUI layout patterns with copy-paste code.

SwiftUI extensions

Includes reusable color, font, and animation helpers for design work.

How to get it

  1. 1Run
    npx skills add wholiver/swiftui-design-skill -g -y

README

SwiftUI Design Skill

"One prompt. A shippable SwiftUI interface."

License Agent-Agnostic Skills

English 中文

Type one line in your agent. Get back a SwiftUI interface that doesn't look AI-generated.

In 3 to 30 minutes, you can design a signature iOS interface — not "AI-made-it-looks-okay" quality, but something that looks like it was crafted by a designer with taste.

Anti-AI Slop 6 Iron Rules, Design Direction Advisor, Brand Asset Protocol, 5-Dimension Review — all built in. Give the skill your brand palette and it will read your vibe; give nothing and the 5 built-in design languages will still hold their ground.

Works across agents — Claude Code, Cursor, Codex, OpenCode, Hermes, all supported.

Install & Go

npx skills add wholiver/swiftui-design-skill -g -y

What Can It Do

CapabilityDeliverableTypical Time
SwiftUI Interface DesignCompilable SwiftUI code · Design system tokens · Layout patterns10–15 min
Design Direction Advisor5 schools × N design philosophies · 3 recommended directions · Visual anchor descriptions5 min
Brand Asset Integrationbrand-spec.md · Color palette · Typography · Spacing system5–10 min
Anti-AI Slop ReviewItem-by-item check · Concrete fix code · Alternative approaches3–5 min
5-Dimension ReviewRadar chart scoring · Keep/Fix/Quick Wins · Actionable fix checklist3 min
Layout Pattern Library9 common layouts · Copy-paste SwiftUI codeInstant
Animation DesignSpring/parallax/pull-to-refresh · Compilable code5–10 min

Core Mechanisms

Anti-AI Slop 6 Iron Rules

This is the hardest set of rules in the skill. All designs must pass these 6 checks:

#Iron Rule❌ Forbidden✅ Alternative
1Start from contextInventing from a blank canvasAsk about design system / UI kit / brand assets first
2Junior Designer ModeWaiting for the perfect solutionGray placeholder > bad SVG
3Give variants, not finalsOne "final answer"2–3 differentiated directions
4Placeholder > bad implementationAI-generated clip artClean gray placeholder + text label
5System-first, don't fillPacking every pixelEvery element must justify its existence
6Ban AI slop patternsPurple-blue gradients, emoji icons, rounded cards + left borderSingle warm accent color, SF Symbols, serif headlines

See references/anti-ai-slop.md for details.

Design Direction Advisor

When requirements are vague, the skill recommends 3 differentiated directions from 5 major design schools:

SchoolCharacteristicsSignature Style
InformationalData-first, chart-denseBloomberg Terminal
EditorialMagazine layout, serif type, generous whitespaceNYT, Medium
ExpressiveBold color, asymmetric layout, motion-forwardStripe, Linear
FunctionalDense tool feel, monospace accentsThings, OmniFocus
Warm MinimalSoft neutrals, rounded corners, subtle textureNotion, Craft

Brand Asset Protocol

A mandatory 5-step hard process when working with a specific brand:

StepActionPurpose
1 · AskDoes the user have brand guidelines?Respect existing assets
2 · SearchSearch the brand's official pagesObtain real materials
3 · DownloadDownload actual asset filesPNG/SVG logos, fonts
4 · VerifyVerify colors match official sourcesCross-check hex values
5 · WriteGenerate brand-spec.mdRecord complete design system

Quality threshold: 5 real brand colors, 10 design tokens, 2 font families, 8pt spacing grid.

5-Dimension Review

Every design must pass a 5-dimension review before delivery:

DimensionScoring CriteriaMinimum Score
🎯 Philosophy ConsistencyDoes the design embody the chosen design philosophy?≥ 7/10
📐 Visual HierarchyIs the information priority clear?≥ 7/10
🔧 Detail ExecutionAre spacing, typography, and colors precise?≥ 7/10
⚡ FunctionalityDoes the layout serve user goals?≥ 7/10
✨ OriginalityIs there at least 1 signature detail?≥ 7/10

File Structure

swiftui-design-skill/
├── SKILL.md                           ← Core definition (278 lines)
├── references/
│   ├── anti-ai-slop.md                ← Anti-AI Slop detailed rules (268 lines)
│   ├── layout-patterns.md             ← 9 layout patterns + copy-paste code (265 lines)
│   ├── typography-color.md            ← Typography hierarchy + color system (172 lines)
│   ├── design-review.md               ← 5-Dimension Review process (151 lines)
│   └── swift-extensions.md            ← Color/Font/Animation extensions (373 lines, essential)
└── templates/
    └── brand-spec.md                  ← Brand spec template (77 lines)

Difference from swiftui-expert-skill

SwiftUI Design Skillswiftui-expert-skill
FocusVisual design, aesthetics, brand feelCode quality, performance, correctness
Question"How does it look?""Is the code correct?"
OutputDesign direction, color palette, layout, reviewCode review, Instruments analysis, API modernization
ComplementaryUse Design first to set directionThen use Expert to ensure code quality

The two skills work together: Design decides what to build, Expert ensures how to build it right.

License

MIT — use freely, but please keep the original author attribution.

Files in the repo

Repository payload9 top-level entries
  • references
  • templates
  • .gitignore
  • LICENSE
  • metadata.json
  • README-zh.md
  • README.md
  • RELEASE-v1.0.0.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k