emil-design-swiftui
Emil Kowalski's design skills, adapted for SwiftUI. Unofficial; based on emilkowalski/skills (MIT).
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 21 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/OrenSegal/emil-design-swiftui with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/OrenSegal/emil-design-swiftui'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/orensegal--emil-design-swiftui)HTML
<a href="/listings/orensegal--emil-design-swiftui"><img src="/api/listings/orensegal--emil-design-swiftui/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills@latest add OrenSegal/emil-design-swiftui
Or, in Claude Code, as a plugin:
claude plugin marketplace add OrenSegal/emil-design-swiftui claude plugin install emil-design-swiftui@emil-design-swiftui
Or copy the folders in `skills/` into `~/.claude/skills/` (or a project's `.claude/skills/`).
The skills use the curves, springs and press style in [`Motion.swift`](Sources/EmilMotion/Motion.swift) by name. Add this repo as a Swift package (product `EmilMotion`, iOS 18 / macOS 15), or copy that file into your app target and drop its `public`s. `xcrun swift test` runs its tests.
The skill names match Emil's originals, so cross-references keep working. If you already have the web versions installed, install these into a project folder instead, or remove the web ones first.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 14 lines
- {
- "name": "emil-design-swiftui",
- "owner": { "name": "Oren Segal" },
- "metadata": { "description": "Unofficial SwiftUI adaptation of Emil Kowalski's skills (emilkowalski/skills, MIT)." },
- "plugins": [
- {
- "name": "emil-design-swiftui",
- "source": "./",
- "description": "Unofficial SwiftUI adaptation of Emil Kowalski's design-engineering and animation skills for native iOS apps. Credit for the design judgment is Emil's; he did not write, review or endorse this port.",
- "version": "0.1.0",
- "license": "MIT"
- }
- ]
- }
README.md · README · 93 lines
- # Emil Kowalski's Skills, for SwiftUI
- [Emil Kowalski](https://emilkowal.ski)'s skills for designers and engineers, adapted for native iOS apps. The design judgment is his. What's new is the implementation: SwiftUI in place of CSS, Motion and React.
- This is an unofficial adaptation of [emilkowalski/skills](https://github.com/emilkowalski/skills). Emil did not write, review or endorse it.
- ## Credit
- These skills are Emil's work. He wrote them from his years of building interfaces at companies like Vercel and Linear, and they hold the small decisions that make an interface feel right: which curve, how fast, where the motion starts, and when to leave it out. Agents tend to get those decisions wrong, which he explains in [Agents with Taste](https://emilkowal.ski/ui/agents-with-taste).
- If these help you, go to the source:
- - Read the originals, with examples and prompts to try, at [aiforui.dev/skills](https://aiforui.dev/skills).
- - [Sign up to his newsletter](https://aiforui.dev/newsletter) for new skills.
- - For anything that runs in a browser, use his web skills: `npx skills@latest add emilkowalski/skills`.
- I'm [Oren Segal](https://github.com/OrenSegal), and I ported them to SwiftUI from upstream commit [`64eb3de`](https://github.com/emilkowalski/skills/tree/64eb3deb9a5fbfa041faf783e0bc3fd635872e9c). Where this port departs from his rules, [CONVERSION.md](CONVERSION.md) and [FLAGGED.md](FLAGGED.md) say how and why. Any mistake in the SwiftUI is mine, not his, so please report it [here](https://github.com/OrenSegal/emil-design-swiftui/issues) rather than on his repo.
- ## What it is
- Emil's reasoning and his values carry over wherever the platform allows. A few rules needed a native reason or a native number, and those changes are listed below. The web implementation has been replaced with native SwiftUI. Rules that only exist because of the browser are not translated. They are listed in [FLAGGED.md](FLAGGED.md) and at the end of each skill, so you can see what was left out and why.
- Target: iOS 18 and Swift 6. APIs newer than iOS 18, like Liquid Glass, only appear behind `#available` with a fallback.
- ## Install
- ```bash
- npx skills@latest add OrenSegal/emil-design-swiftui
- ```
- Or, in Claude Code, as a plugin:
- ```bash
- claude plugin marketplace add OrenSegal/emil-design-swiftui
- claude plugin install emil-design-swiftui@emil-design-swiftui
- ```
- Or copy the folders in `skills/` into `~/.claude/skills/` (or a project's `.claude/skills/`).
- The skills use the curves, springs and press style in [`Motion.swift`](Sources/EmilMotion/Motion.swift) by name. Add this repo as a Swift package (product `EmilMotion`, iOS 18 / macOS 15), or copy that file into your app target and drop its `public`s. `xcrun swift test` runs its tests.
- The skill names match Emil's originals, so cross-references keep working. If you already have the web versions installed, install these into a project folder instead, or remove the web ones first.
- ## What changed from the web version
- - **Kept as is:** every rule about frequency, purpose, easing, duration, origin, interruption, asymmetry and restraint, with Emil's original values.
- - **One new rule:** leave system motion alone. Sheets, navigation pushes, menus and popovers already move the way iOS users expect, and they already respect Reduce Motion. Emil's curves are for the components you build.
- - **Reframed:** some rules hold but for a different reason natively. For example, an interrupted spring hands its velocity to the new target, so springs play the role CSS transitions play on the web. A timing curve keeps running and stacks with the new one, which is why curves are the wrong choice for anything the user can reverse. Sonner's swipe-to-dismiss threshold of 0.11 px/ms is an average over the whole drag, while SwiftUI reports the release velocity, so the native threshold is 500 pt/s. A small [probe app](Examples/README.md) confirms this on a simulator. [CONVERSION.md](CONVERSION.md) lists every mapping.
- - **Not ported:** `animate-expo` (React Native) and `ask-sonner` (a React library). The ideas from them that apply natively live in `animate`, `gestures` and `emil-design-eng`.
- - **Unchanged:** `write-swift` was already native.
- ## Checking the code
- Two checks run on every push (`.github/workflows/check.yml`). The first checks structure: front matter the installer needs, every upstream skill accounted for, and links and cross-references that resolve:
- ```bash
- tools/validate.sh
- ```
- The second typechecks every Swift snippet in the ported skills with an iOS 18 deployment target in Swift 6 mode, debug code included:
- ```bash
- tools/check-snippets.sh $(ls skills/*/*.md | grep -v /write-swift/) *.md
- ```
- Run the snippet check outside any sandbox, since the Swift macro plugin server needs its own. Three blocks in `write-swift` fail on purpose. That skill is Emil's original, unchanged. Its examples are fragments that call made-up helpers.
- A weekly job (`tools/upstream-diff.sh`) fails when Emil's repo moves past the pinned commit and lists the files he changed, so the port can follow him.
- ## Reference
- - **[emil-design-eng](skills/emil-design-eng/SKILL.md)**: the core skill. Mostly animation, plus component polish.
- - **[animate](skills/animate/SKILL.md)**: builds one animation, choosing curve, duration, properties and exit.
- - **[review-animations](skills/review-animations/SKILL.md)**: a strict review of the motion in a diff.
- - **[improve-animations](skills/improve-animations/SKILL.md)**: audits every animation in an app and writes plans another agent can run.
- - **[find-animation-opportunities](skills/find-animation-opportunities/SKILL.md)**: finds where motion would help, and says where it wouldn't.
- - **[remove-animations](skills/remove-animations/SKILL.md)**: removes the motion an app doesn't need.
- - **[choreograph](skills/choreograph/SKILL.md)**: coordinates several views moving together.
- - **[animation-performance](skills/animation-performance/SKILL.md)**: fixes dropped frames, written for the SwiftUI render pipeline.
- - **[animation-vocabulary](skills/animation-vocabulary/SKILL.md)**: names a motion effect and the SwiftUI API that makes it.
- - **[apple-design](skills/apple-design/SKILL.md)**: Apple's fluid-interface principles, back on their home platform.
- - **[gestures](skills/gestures/SKILL.md)**: drags, swipes and sheets that track the finger and carry the release velocity.
- - **[pick-ui-library](skills/pick-ui-library/SKILL.md)**: the first-party component for each task. It names no third-party packages.
- - **[prototype](skills/prototype/SKILL.md)**: several versions of a view behind a switcher.
- - **[mobile-native](skills/mobile-native/SKILL.md)**: mostly flagged, since a native app has none of the web-on-a-phone problems. The few rules that carry over are kept.
- - **[break-ui](skills/break-ui/SKILL.md)**: worst-case data, plus Dynamic Type, right-to-left and accessibility settings.
- - **[learn-taste](skills/learn-taste/SKILL.md)**: turns a session's design corrections into rules.
- - **[ask-emil](skills/ask-emil/SKILL.md)**: points you to the right skill.
- - **[write-swift](skills/write-swift/SKILL.md)**: modern Swift and Swift 6 concurrency.
- ## License
- MIT, as in the original. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.