An agentic skills framework & software development methodology that works.
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.
Builders who use agent tools to design SwiftUI and iOS interfaces with a clearer visual style.
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
- 1Run
npx skills add wholiver/swiftui-design-skill -g -y
README
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
| Capability | Deliverable | Typical Time |
|---|---|---|
| SwiftUI Interface Design | Compilable SwiftUI code · Design system tokens · Layout patterns | 10–15 min |
| Design Direction Advisor | 5 schools × N design philosophies · 3 recommended directions · Visual anchor descriptions | 5 min |
| Brand Asset Integration | brand-spec.md · Color palette · Typography · Spacing system | 5–10 min |
| Anti-AI Slop Review | Item-by-item check · Concrete fix code · Alternative approaches | 3–5 min |
| 5-Dimension Review | Radar chart scoring · Keep/Fix/Quick Wins · Actionable fix checklist | 3 min |
| Layout Pattern Library | 9 common layouts · Copy-paste SwiftUI code | Instant |
| Animation Design | Spring/parallax/pull-to-refresh · Compilable code | 5–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 |
|---|---|---|---|
| 1 | Start from context | Inventing from a blank canvas | Ask about design system / UI kit / brand assets first |
| 2 | Junior Designer Mode | Waiting for the perfect solution | Gray placeholder > bad SVG |
| 3 | Give variants, not finals | One "final answer" | 2–3 differentiated directions |
| 4 | Placeholder > bad implementation | AI-generated clip art | Clean gray placeholder + text label |
| 5 | System-first, don't fill | Packing every pixel | Every element must justify its existence |
| 6 | Ban AI slop patterns | Purple-blue gradients, emoji icons, rounded cards + left border | Single 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:
| School | Characteristics | Signature Style |
|---|---|---|
| Informational | Data-first, chart-dense | Bloomberg Terminal |
| Editorial | Magazine layout, serif type, generous whitespace | NYT, Medium |
| Expressive | Bold color, asymmetric layout, motion-forward | Stripe, Linear |
| Functional | Dense tool feel, monospace accents | Things, OmniFocus |
| Warm Minimal | Soft neutrals, rounded corners, subtle texture | Notion, Craft |
Brand Asset Protocol
A mandatory 5-step hard process when working with a specific brand:
| Step | Action | Purpose |
|---|---|---|
| 1 · Ask | Does the user have brand guidelines? | Respect existing assets |
| 2 · Search | Search the brand's official pages | Obtain real materials |
| 3 · Download | Download actual asset files | PNG/SVG logos, fonts |
| 4 · Verify | Verify colors match official sources | Cross-check hex values |
| 5 · Write | Generate brand-spec.md | Record 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:
| Dimension | Scoring Criteria | Minimum Score |
|---|---|---|
| 🎯 Philosophy Consistency | Does the design embody the chosen design philosophy? | ≥ 7/10 |
| 📐 Visual Hierarchy | Is the information priority clear? | ≥ 7/10 |
| 🔧 Detail Execution | Are spacing, typography, and colors precise? | ≥ 7/10 |
| ⚡ Functionality | Does the layout serve user goals? | ≥ 7/10 |
| ✨ Originality | Is 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 Skill | swiftui-expert-skill | |
|---|---|---|
| Focus | Visual design, aesthetics, brand feel | Code quality, performance, correctness |
| Question | "How does it look?" | "Is the code correct?" |
| Output | Design direction, color palette, layout, review | Code review, Instruments analysis, API modernization |
| Complementary | Use Design first to set direction | Then 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
- 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 itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More skills

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.
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.
Public repository for Agent Skills
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…)

Production-grade engineering skills for AI coding agents.